fresh-project
Use when starting a new project from scratch, bringing an idea to life in a blank codebase, or when onboarding detects a greenfield project. Walks through discovery, stack selection, scaffolding, and hands off to implementation. Also use when user says “fresh project”, “new project”, “build something new”, or “I have an idea”.
| Model | Source |
|---|---|
| opus | pack: fresh-project |
Tools: Read, Glob, Grep, Bash, Write, Edit, Task, AskUserQuestion, Skill, WebSearch, WebFetch
Context: fork
Full Reference
Fresh Project
Section titled “Fresh Project”The zero-to-shipped orchestrator. Takes a user from “I have an idea” to a scaffolded, planned project ready for implementation. Five sequential phases with hard gates between them — each phase produces artifacts the next phase requires. Three entry points: onboarding auto-detection, shepherd routing on natural language, or explicit /fresh-project invocation. State is persisted in .claude/fresh-project.json so interrupted sessions can resume exactly where they left off.
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| Phases | Discovery → Stack → Scaffold → Plan → Build |
| State file | .claude/fresh-project.json |
| Project brief | .claude/PROJECT.md |
| Stack decisions | .claude/stack.json |
| Phase 4 skill | writing-plans |
| Phase 5 skill | executing-plans or subagent-driven-development |
| Phase skip policy | Hard gate — never skip, explain what’s needed first |
| Reset command | fresh-project --reset |
Announcement
Section titled “Announcement”┏━ 🛡 fresh-project ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ let’s bring this to life ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
Reference Index
Section titled “Reference Index”| I want to… | File |
|---|---|
| Understand entry points and re-entry from fresh-project.json | reference/entry-points-and-reentry.md |
| Run Phase 1 — adaptive discovery conversation and PROJECT.md | reference/phase1-discovery.md |
| Run Phase 2 — stack selection via fullstack-architect agent | reference/phase2-stack-selection.md |
| Run Phase 3 — scaffold via project-scaffolder agent | reference/phase3-scaffold.md |
| Run Phase 4 — architecture planning via writing-plans | reference/phase4-planning.md |
| Run Phase 5 — build execution via executing-plans | reference/phase5-build.md |
| Handle off-path scenarios (partial project, mature codebase, reset) | reference/edge-cases.md |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.