What This Skill Does

Scaffold a new project from an empty (or near-empty) directory. Conduct a structured interview to understand what's being built, why, and how — then execute the scaffolding using official CLI tools, install dependencies at latest versions, and generate foundation documents that future Claude sessions can build on.

The goal is a codebase foundation with clear patterns that can be replicated for every feature built on top of it. The interview is thorough because getting the foundation right matters more than getting it fast.

Starting

Before asking anything, inspect the current working directory:

Check what exists. Run ls -la and look for project markers: package.json, Cargo.toml, pyproject.toml, go.mod, .git/, CLAUDE.md, src/, etc.
If a project already exists (has a framework config, dependency file, or substantial source code): warn the user. Say something like: "This directory already has a [Next.js / Python / etc.] project. Did you mean to add a feature (/plan-feature) or start a fresh project in a subdirectory?" Let them decide before proceeding.
If files exist but it's minimal (just a README, .git, or a few stray files): note what's there and proceed. Mention what you found so the user knows you're aware.
If empty or nearly empty: proceed directly to the interview.

Then open with context:

scaffold-repo

What This Skill Does

Starting