Discover and specify a new software project from scratch
Transform vague ideas into actionable project specifications through structured discovery. Use this when starting a new project from scratch to define requirements, architecture, and implementation roadmap.
/plugin marketplace add benshapyro/cadre-devkit-claude/plugin install benshapyro-cadre-devkit-claude@benshapyro/cadre-devkit-claudeproject idea or problemTransform a new idea into actionable specifications through structured discovery.
Before starting: Read .claude/skills/product-discovery/SKILL.md for methodology and templates.
Not for: Adding features to existing projects (use /plan instead)
Creates three documents in docs/:
docs/SPEC.md - What to build (requirements, users, success criteria)docs/DESIGN.md - How to build it (architecture, technology choices)docs/PLAN.md - Implementation roadmap (phases, tasks, go/no-go)Understand the core idea and motivation.
Identify the essential problem to solve first.
Define specific user types and their needs.
Explore constraints and technology options.
Define success metrics and failure conditions.
Define MVP boundaries using effort-based framing:
| Scope | Definition |
|---|---|
| Core MVP | ONE problem, ONE user type |
| Expanded MVP | Multiple features, single user focus |
| Full Vision | All features, all users |
1. User provides idea/problem
2. Interactive discovery (phases 1-6)
3. After each phase: Update relevant doc sections
4. Review complete specs with user
5. Finalize and save to docs/
6. Suggest next step: /plan [first feature]
Ask, don't assume:
Progressive documentation:
Scope control:
User: /greenfield I want to build a tool that helps developers track their learning progress
Claude: Great idea! Let's explore this together and create specifications.
**Phase 1: Vision**
What moment made you think "someone should build this"? What were you trying to do when you had this idea?
[... interactive discovery continues ...]
After exploring your idea, I've created three documents:
- `docs/SPEC.md` - Your learning tracker specification
- `docs/DESIGN.md` - Technical architecture decisions
- `docs/PLAN.md` - Implementation roadmap
**MVP Scope:** Personal progress dashboard with manual entry
**Full Vision:** Social features, spaced repetition, integrations
Ready to start building? Run:
`/plan Implement basic progress tracking with manual entry`
After discovery is complete:
/planNext Steps:
/plan [first MVP feature] - Start implementation/research [technical topic] - Deep dive on unknowns