Your First Project¶
This guide walks you through creating your first project with the toolkit, from scaffolding to your first commit.
Prerequisites¶
- Toolkit installed and verified (see Installation)
- A Git repository you want to work in (or create a new one)
Step 1: Start the Workflow¶
Open Claude Code in your project directory and run:
This shows the complete development workflow and validates your project is ready:
Step 2: Bootstrap the Project¶
If this is a new project, scaffold the standard structure:
This creates:
CLAUDE.mdwith project-specific instructions- Standard folder structure
- CI/CD configuration
- Documentation scaffolding
If your project already has structure, the bootstrap skill adapts to what exists.
Step 3: Plan Your Feature¶
Before writing code, create an implementation plan:
This orchestrates the SpecKit pipeline:
- Specify — Define the feature in a structured spec
- Plan — Design the architecture and approach
- Tasks — Break the plan into ordered, actionable tasks
The result is a specs/ directory with your feature's spec, plan, and task list.
Step 4: Build¶
With a plan in place, start implementation:
This guides you through executing the task list while capturing decisions in the session journal.
Step 5: Review¶
When implementation is complete, run the multi-agent review:
Six parallel reviewers check security, code quality, performance, patterns, testing, and documentation.
Step 6: Deploy¶
Before merging, run the deployment check:
This verifies security, migration safety, and compliance before release.
Choosing the Right Workflow¶
The toolkit supports three workflows. Choose based on your task:
| Workflow | Start command | Best for |
|---|---|---|
| Development | /0-start |
Code features, bug fixes, refactoring |
| Product Design | /pd-0-start |
User research, PRDs, prototypes, design handoff |
| Knowledge Work | /kw-0-start |
Documentation, research, processes, non-code deliverables |
Each workflow has its own sequence of phases. Run the start command to see the full flow.