scaffold-exercises

Parse the plan to extract section names, exercise names, and variant types, then create directories with mkdir -p following the XX-section and XX.YY-exercise naming pattern. Add a stub readme.md to each variant folder and run the lint command to validate.

Each exercise needs at least one of problem/, solution/, or explainer/ subfolders, and the primary subfolder must contain a non-empty readme.md with no broken links. Subfolders with code also need a main.ts file, though readme-only stubs are acceptable.

Use git mv instead of mv to rename exercise directories, which preserves git history. Update the numeric prefix to maintain ordering, then re-run pnpm ai-hero-cli internal lint to confirm the structure still validates.

Lint fails when readme.md files are empty or missing, when .gitkeep or speaker-notes.md files exist, when readmes contain broken links or pnpm run exercise commands, or when no problem, solution, or explainer subfolder exists.

Default to the explainer/ variant when stubbing unless the plan specifies otherwise. Explainers hold conceptual material without TODOs, while problem/ is the student workspace and solution/ holds the reference implementation.