claude
863435915c
Co-authored-by: claude <claude@jpaul.io> Co-committed-by: claude <claude@jpaul.io>
58 lines
4.0 KiB
Markdown
58 lines
4.0 KiB
Markdown
# 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 1–2), one post per *unit* for the
|
||
faster-moving back half (Units 3–5), 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 (M13–19) | AI Made Writing Code Cheap. Now Automate the Catching. |
|
||
| 15 | `15-unit4-extend-the-ai.md` | Unit 4 (M20–23) | Giving the AI Hands: Extending It Into Your Real Systems |
|
||
| 16 | `16-unit5-ai-in-the-loop.md` | Unit 5 (M24–27) | 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
|
||
|
||
- [x] `[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.
|