The premise
Scaffolding is mechanical; AI is good at it when your spec names files, exports, and inputs precisely.
What AI does well here
- Create a directory tree and stubbed files from an explicit spec.
- Wire up imports between stubs that match a stated module shape.
What AI cannot do
- Invent a sound architecture from a vague one-liner.
- Make build/runtime choices for you (bundler, target, runtime).
End-of-lesson check
15 questions · take it digitally for instant feedback at tendril.neural-forge.io/learn/quiz/end-ai-coding-spec-to-skeleton-r12a1-creators
What kind of work is scaffolding a new project mostly considered to be?
- Deeply creative architecture work
- Largely mechanical setup work
- Pure debugging
- Performance tuning
Which input does a strong scaffold prompt name precisely?
- The user's IDE color theme
- Files, exports, and module shape
- The maintainer's birthday
- The current weather
Which sentence best fits a scaffold prompt that gets useful output?
- 'Build me a startup.'
- 'Generate the file tree and stub files; each function gets a signature plus a TODO comment, no implementations.'
- 'Write a great codebase.'
- 'Surprise me with whatever framework you like.'
Why is asking for stubs without implementations useful at the scaffold stage?
- It keeps the diff reviewable and avoids premature implementation choices
- It makes the project run faster in production
- It guarantees zero bugs
- It removes the need to write tests later
Which task is AI good at when you provide an explicit module spec?
- Inventing your domain model from a one-liner
- Wiring imports between stubs that match a stated module shape
- Choosing your company's pricing model
- Picking your team's vacation policy
What does AI typically fail to do well for a scaffold?
- Generate a folder hierarchy from clear inputs
- Add a TODO comment to a stub
- Invent sound architecture from a vague one-liner
- Match your stated export names
Which decision should not be delegated to the AI during scaffolding?
- Filename casing inside a stated convention
- Bundler, target runtime, and build choices
- Adding a TODO comment
- Naming a function the spec already named
Why is a directory full of TODOs misleading as a measure of progress?
- TODOs are illegal in most languages
- Stubs feel like progress but no behavior is verified yet
- TODOs prevent git commits
- TODOs change file extensions
What signal indicates real, not cosmetic, progress on a fresh skeleton?
- The number of TODO comments grows
- The first end-to-end test passes
- The README gets longer
- The file count crosses 100
What is the safest order of operations when starting a new project with AI?
- Generate stubs, then write a spec to match them
- Write a spec, generate stubs, then drive an end-to-end test green
- Skip the spec entirely and prompt freely
- Write the README first and never touch code
Which is a sound use of stubs?
- Shipping them to production unchanged
- Using them as a checklist for the implementations that still need to happen
- Counting each stub as a finished feature
- Promising stakeholders the project is done
Why is naming exports in the spec so important?
- Export names anchor the module graph the AI must wire
- Export names change the function's runtime
- Exports affect file color in the IDE
- Exports rename the language being used
A teammate prompts: 'Make me a project.' Which problem is most likely?
- The model refuses to respond at all
- The model invents architecture, stack, and naming you did not want
- The model produces nothing
- The IDE crashes
Why pair stubs with explicit signatures rather than empty function bodies?
- Signatures act as a contract for both humans and AI to fill in later
- Signatures prevent any future changes
- Signatures make code unreadable
- Signatures cause type errors on purpose
Which mindset best fits scaffold-stage AI use?
- The AI's stubs are now the source of truth
- The stubs are a draft skeleton to be implemented and tested
- The stubs replace any need for code review
- The stubs guarantee the project will ship