Files
ai-workflow-course/blog
claude a3c2872526
CI / check (pull_request) Successful in 7s
feat(blog): inline terminal screenshots for M12, Unit 4 (both), and Unit 5
Four real-capture terminal screenshots covering the last of the automatable
blog placeholders:

- m12-reflog.png:      real git reflog on a demo repo where an agent's
                       reset --hard lost a "6h of work" commit. The lost
                       commit line (HEAD@{2}, feat: add count command) is
                       highlighted amber so the reader's eye lands on the
                       recovery target.

- u4-mcp.png:          the tasks MCP server actually queried via stdio
                       JSON-RPC (real tools/list response). Shows the
                       project's .mcp.json, then claude mcp list marking
                       tasks as Connected, then a tool list with the real
                       tool signatures (list_tasks() and add_task(title:
                       string)) with their live descriptions from the server.

- u4-orient-diff.png:  two side-by-side terminals. Left: real head -18 of
                       ORIENT.md produced by the M23 lab's orient.py against
                       a small quotient demo project. Right: a real, tightly
                       scoped git diff on src/quotient.py adding a
                       divide-by-zero guard. Facts first, then one small
                       change, exactly M23's teaching.

- u5-reviewer.png:     real python3 reviewer.py apply ai-review.sample.json
                       from the M24 lab. Shows the reviewer's output: summary,
                       three findings sorted by severity (BLOCKER in red,
                       SUGGESTION in amber, NIT dim), the agent's
                       recommendation (request_changes), and the explicit
                       "human decides" gate section.

Uploaded to WP as media 17197 (M12), 17198+17199 (Unit 4), 17200 (Unit 5).
Embedded in drafts #17132 (M12), #17136 (Unit 4), #17138 (Unit 5), all
scheduled: M12 Thu 2026-08-06, Unit 4 Thu 2026-08-13, Unit 5 Tue 2026-08-18.

Unit 3 (#17134, Tue 2026-08-11) and Capstone (#17140, Thu 2026-08-20) are
scheduled and awaiting Justin's screenshots of a real red-CI PR (recklessop/
m11-worktrees-demo#5) and a real green-CI PR (recklessop/m11-worktrees-demo#4)
respectively, both set up by this batch.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT
2026-07-02 16:59:26 -04:00
..

Blog posts (jpaul.me)

Drafts of blog posts for jpaul.me that promote and add value around The Workflow course. This folder is not course content; it lives here only so the drafts are version-controlled alongside the material they describe. Pull it out before any public GitHub mirror push if you don't want the drafts shipped publicly.

Conventions

  • One Markdown file per post, numbered in intended publish order: NN-slug.md.
  • Each file opens with a metadata block (suggested title, slug, meta description, tags) for easy paste into WordPress; delete it before publishing or keep it as notes.
  • Screenshots are left as [insert a screenshot referencing XYZ here] placeholders for Justin to fill before publishing.
  • Voice: conversational, first-person, value-first. Course link is a soft CTA, not the whole point; each post should stand on its own for a reader who never takes the course.

Publishing cadence & manifest

Structure: announcement + getting-started, then a weekly series. Hybrid granularity: one post per module for the durable core (Units 12), one post per unit for the faster-moving back half (Units 35), plus a capstone finale. 17 posts total.

# File Covers Working title
01 01-announcing-the-workflow.md Announcement / thesis Your AI Already Writes Good Code. That's Not Your Problem.
02 02-getting-started-the-copy-paste-problem.md Module 1 + setup The Copy-Paste Problem (and How to Actually Get Started)
03 03-version-control-safety-net.md Module 2 Git Is Undo for the AI (and Memory It Can Read Back)
04 04-version-control-for-words.md Module 3 Version Control Isn't Just for Code: Start With Your Words
05 05-getting-the-ai-out-of-the-browser.md Module 4 Let the AI Edit Your Files (Yes, Really: Here's Why It's Safe)
06 06-commit-the-ai-config.md Module 5 Commit the AI's Config, Not Just the Code
07 07-branches-sandboxes.md Module 6 Let the AI Try Something Reckless, on a Branch
08 08-worktrees-parallel-agents.md Module 7 Stop Making Your Agents Take Turns: Git Worktrees
09 09-remotes-and-hosting.md Module 8 Your Repo Lives on One Disk. That's One Spilled Coffee From Gone.
10 10-issues-task-layer.md Module 9 Who Picks This Up? Writing Issues for a Team of Humans and Agents
11 11-reviewing-code-you-didnt-write.md Module 10 The AI's Code Looks Right. That's the Problem.
12 12-collaboration-humans-and-agents.md Module 11 Half Your Teammates Aren't Human (and the Loop Doesn't Care)
13 13-revert-reset-recovery.md Module 12 Your AI Just Force-Pushed Over a Day of Work. Now What?
14 14-unit3-automate-checking-shipping.md Unit 3 (M1319) AI Made Writing Code Cheap. Now Automate the Catching.
15 15-unit4-extend-the-ai.md Unit 4 (M2023) Giving the AI Hands: Extending It Into Your Real Systems
16 16-unit5-ai-in-the-loop.md Unit 5 (M2427) Letting the AI Off the Leash (Without Getting Bitten)
17 17-capstone-the-full-loop.md Capstone The Full Loop: One Feature, End to End

Each file's top-of-file HTML comment holds the suggested title, slug, meta description, and tags for WordPress. Titles above are starting points; every post also carries an alt title in its metadata block.

Before publishing: checklist

  • [COURSE LINK] placeholders filled with the course URL https://git.jpaul.io/justin/ai-workflow-course. At public launch: (a) if the GitHub mirror becomes the public home, swap these to the mirror URL; (b) inline cross-post references ("announcement post", "last post", "course lab") currently all point at the course home; repoint them to the specific jpaul.me post URLs (or wiki module pages) once those exist.
  • Fill every [insert a screenshot referencing XYZ here] placeholder with a real image.
  • Decide whether to keep or strip the top-of-file metadata comment block.