scaffold-claude

Scaffold a CLAUDE.md for the user's project. Output is written to a scratchpad so the user can review and move it to the repo root themselves.

The file you produce documents edge cases, non-obvious choices, and tribal knowledge — things Claude can't read off package.json, the directory tree, or the README. If a fact is derivable, it does not belong in the file.

The Iron Rule

Never write a section based on inference. Always ask, and stub when the answer is "skip" or "I don't know."

A stubbed section (a <!-- TODO: ... --> comment) is strictly better than a section filled with plausible-sounding guesses. Guesses encode false confidence that future Claude will trust.

When to Use

• User says /scaffold-claude or asks to "scaffold/write/create CLAUDE.md"
• User asks for an AGENTS.md (same shape, different filename — ask which)
• User has a project but no CLAUDE.md and wants one
• User has a CLAUDE.md they want to redo from scratch