Scaffold

/scaffold

Usage: /scaffold "<slug>" "<one-liner>"

Example: /scaffold "formpad" "A form builder for indie SaaS founders that auto-generates schema from prompts."

What this does

Creates a complete starting point for a new product:

1. Folder structure at products/<slug>/:

   products/<slug>/
   ├── product.config.json
   ├── CLAUDE.md
   ├── scope.md
   ├── prd.md
   ├── metrics.md (skeleton, fill in via metric-framework-designer later)
   ├── SETUP.md (the one-time setup checklist)
   ├── README.md
   ├── decisions/
   │   └── 0001-scaffold.md
   ├── interviews/
   │   └── README.md
   ├── launch/
   │   └── README.md
   ├── analytics/
   │   └── README.md
   └── code/ → symlink or new Next.js app (see step 2)
   

2. Next.js starter — copies templates/product-starter-nextjs/ to products/<slug>/code/ with the name, slug, and one-liner substituted into:

   • package.json (name)
   • .env.example (NEXT_PUBLIC_APP_NAME)
   • src/app/(marketing)/page.tsx (hero copy)
   • src/app/layout.tsx (default metadata)
   • next.config.mjs (if needed)
   • README.md

3. product.config.json — the dashboard registry entry:

   {
     "slug": "<slug>",
     "name": "<Title Case Name>",
     "one_liner": "<one-liner>",
     "created": "<ISO date>",
     "stage": "idea",
     "status": "scaffolded",
     "code_path": "products/<slug>/code",
     "aliases": [],
     "analytics": {
       "stripe_account_id": null,
       "posthog_project_id": null,
       "ga4_measurement_id": null,
       "plausible_domain": null,
       "sentry_org": null,
       "sentry_project": null,
       "gsc_property": null,
       "ahrefs_target": null
     },
     "links": {
       "github": null,
       "prod_url": null,
       "staging_url": null
     }
   }
   

4. CLAUDE.md in the product folder — uses templates/claude-md-template.md with substitutions.

5. scope.md — uses templates/scope-doc-template.md, with Claude's first-pass fill from the one-liner. User edits in next session.

6. PRD skeleton — uses templates/prd-template.md, Claude pre-fills sections that can be inferred from the one-liner; rest are clearly marked TODO.

7. SETUP.md — the exact 11-step setup checklist from stack/analytics-stack.md, with the product's specific URLs for service signups pre-filled.

8. First decision log entry in decisions/0001-scaffold.md:

   ## YYYY-MM-DD — Scaffolded
   Created via /scaffold. One-liner: "<one-liner>".
   Stage: idea. Stack: default per stack/tech-stack.md.
   Next: complete SETUP.md, run /validate <slug>.
   

What you do as the assistant when this is invoked

1. Parse <slug> and <one-liner> from the user's invocation.
2. Validate slug: lowercase, hyphens only, no spaces. If invalid, ask for correction.
3. Validate uniqueness: error if products/<slug>/ exists.
4. VALIDATION GATE: Unless the user said "skip validation" or explicitly the user already has validation evidence (cite the source: e.g. products/<slug>/validation/snapshot.md from a prior /validate run), ask: "I don't see validation evidence for this product. Are you sure you want to scaffold before validating? (yes / run /validate first)"
5. If user proceeds: create folder structure, copy template, do the substitutions.
6. Generate the doc skeletons by reading the templates and filling from the one-liner.
7. Print the SETUP.md checklist as the final message so the user knows the manual steps remaining.
8. Print "next: run pnpm install && pnpm dev in products//code/ — landing page should boot at localhost:3000".

Edge cases

• If templates/product-starter-nextjs/ doesn't exist yet, scaffold the doc files only and tell the user to wait for the starter (Phase C of this build pass).
• If user provides only <slug> without <one-liner>, ask for the one-liner once. Don't proceed without it.