← Back to Skills
Misc

Scaffold Exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting.

Scaffold Exercises

Create exercise directory structures that pass linting, then commit with git commit.

Directory naming

  • Sections: XX-section-name/ inside exercises/
  • Exercises: XX.YY-exercise-name/ inside a section
  • Names are dash-case (lowercase, hyphens)

Exercise variants

Each exercise needs at least one of these subfolders:

  • problem/ - student workspace with TODOs
  • solution/ - reference implementation
  • explainer/ - conceptual material, no TODOs

Required files

Each subfolder needs a readme.md that is not empty and has no broken links.

Workflow

  1. Parse the plan - extract section names, exercise names, and variant types
  2. Create directories - mkdir -p for each path
  3. Create stub readmes - one readme.md per variant folder with a title
  4. Run lint - validate
  5. Fix any errors - iterate until lint passes