| name | scaffold-exercises |
| description | Create exercise dirs, readmes, variants, and lint-clean course stubs. |
Scaffold Exercises
Create exercises/ structure that passes pnpm ai-hero-cli internal lint, then commit.
Naming
- Sections:
XX-section-name/
- Exercises:
XX.YY-exercise-name/
- dash-case names.
Variants
Each exercise needs at least one: problem/, solution/, explainer/. Default stub: explainer/.
Each variant needs non-empty readme.md. Code variants also need main.ts >1 line.
Workflow
- Parse plan -> sections, exercises, variant types.
mkdir -p dirs.
- Create stub readmes with title + sentence.
- Run
pnpm ai-hero-cli internal lint.
- Fix until green.
Moving
Use git mv, update numeric prefixes, rerun lint.
No .gitkeep, speaker-notes.md, broken links, or pnpm run exercise in readmes.