scaffold-exercises

Parse the plan to extract section names, exercise names, and variant types, then create folders with mkdir -p using the XX-section-name and XX.YY-exercise-name conventions. Add a readme.md stub with a title to each variant subfolder, then run the lint command to validate.

Each problem, solution, or explainer subfolder needs a non-empty readme.md with real content and no broken links. If the subfolder contains code, it also needs a main.ts file with more than one line, 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 the lint command to confirm the new 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. Fix each reported issue and re-run pnpm ai-hero-cli internal lint.

Default to the explainer variant when stubbing unless the plan specifies otherwise. Explainer folders hold conceptual material with no TODOs, while problem folders are student workspaces and solution folders hold reference implementations.