# Set Up Workflow: Claude Code Spec-Driven Development Workflow
## What This Is
This tool automates software development by creating a structured process for building features and fixing bugs. It takes a high-level requirement, breaks it down into technical plans and individual tasks, and then uses AI to implement the code, increasing developer productivity and consistency.
Source: https://github.com/Pimzino/claude-code-spec-workflow
## Before You Start
Scan my workspace and analyze:
- The project language, framework, and directory structure
- Existing AI provider config (check .env, .env.local, config files for API keys — OpenRouter, OpenAI, Anthropic, Google AI, etc.)
- Whether this repository or a similar tool is already cloned or installed
Then ask me before proceeding:
1. Which AI provider/API should this use? (Use whatever I already have configured, or ask me to set one up — options include direct provider APIs or a unified service like OpenRouter)
2. Where in my project should this be integrated?
3. Are there any customizations I need (model preferences, naming conventions, constraints)?
## Fetch the Source
Clone or inspect the repository to understand what needs to be installed:
```bash
gh repo clone Pimzino/claude-code-spec-workflow
```
Review the README, directory structure, and any install instructions before proceeding.
## What to Implement
This is an **AI Workflow** — an end-to-end automation pattern or integration pipeline.
- Study the workflow architecture from the source and context below
- Identify which parts I can implement locally vs. parts that need external services
- For local parts: implement them using my existing stack and API keys
- For external parts: tell me exactly what services I need and help me configure the integration code
- Wire up any required API calls using keys from my .env files
## Additional Context
- Execute the following command in the user's terminal to install the workflow package globally: `npm i -g @pimzino/claude-code-spec-workflow`.
- Navigate into the root of the user's active project directory and run the setup command `claude-code-spec-workflow` to initialize the `.claude/` structure and commands.
- To demonstrate the workflow, initiate a new feature specification by running the command `/spec-create user-profile "Create a basic user profile page with display name and avatar."` and report back the generated files.
## Reference Implementation
```
```bash
npm i -g @pimzino/claude-code-spec-workflow
claude-code-spec-workflow
```
```
## Guidelines
- Adapt everything to my existing project — do not assume a specific stack or directory layout
- Use whichever AI provider I already have configured; if I need a new one, tell me what to sign up for and I'll give you the key
- Check my .env files for existing API keys (OpenRouter, OpenAI, Anthropic, Google AI) before asking me to add one
- Review any fetched code for safety before installing or executing it
- After setup, run a quick verification and show me a summary of exactly what was installed, where, and how to use it