project-prep

A pre-production scaffolder for Claude Code. Give it a raw project idea; it runs a discovery interview, researches the domain and tech, and generates a full production-bible repository: vision, architecture, technology radar + ADRs, a phased task tracker, GitHub setup, runbooks, a one-page memo, and a recorded ENV.

Domain-agnostic: games, interactive 3D / architectural visualization, desktop/web apps, tools.

Use it as a skill

This folder lives at ~/.claude/skills/project-prep/. In any project, invoke it:

/project-prep

or just say: "help me prepare a new project / set up a production bible for ".

It composes with the grilling interview skill — if grilling is installed, project-prep uses it for the intake interview; otherwise it follows the embedded question tree in references/01_intake.md.

Use it as a standalone repository

This folder is self-contained. To publish it:

cd ~/.claude/skills/project-prep
git init && git add -A && git commit -m "project-prep skill"
gh repo create project-prep --public --source=. --push

Others can install it by copying the folder into their own ~/.claude/skills/.

What it produces

See references/03_structure.md for the canonical output. In short: a <Project>_Documentation/ package + a tracker + .github/ templates, all filled with the specific project's content — ready to execute task-by-task.

Layout

project-prep/
  SKILL.md                  the process (5 stages: Intake → Research → Decide → Scaffold → Finalize)
  references/
    00_terminology.md       correct industry names for every artifact
    01_intake.md            discovery question tree (+ per-domain branches)
    02_research.md          pre-production research checklist
    03_structure.md         canonical production-bible structure
  templates/                verbatim files to copy & adapt
    ONEPAGER.md
    Task_Status_Register.md
    ADR-0000-template.md
    github/
      task.yml
      PULL_REQUEST_TEMPLATE.md
      labels.yml

Credit

Interview method adapted from Matt Pocock's grilling skill.