.png)
3 months ago
2
Automated spec-driven workflow for Claude Code. Transform feature ideas into complete implementations through Requirements → Design → Tasks → Implementation.
Install and run in any project directory:
npx @pimzino/claude-code-spec-workflow
That's it! The workflow will be automatically set up in your project.
# Run once in your project directory
npx @pimzino/claude-code-spec-workflow
# Test the setup
npx @pimzino/claude-code-spec-workflow test
# Install globally
npm install -g @pimzino/claude-code-spec-workflow
# Use anywhere
claude-spec-setup
# Install as dev dependency
npm install --save-dev @pimzino/claude-code-spec-workflow
# Run via package.json script
npx claude-spec-setup
The setup automatically creates:
- 📁 .claude/ directory structure with all necessary files
- 📝 7 slash commands for the complete workflow
- 🤖 Auto-generated task commands for each spec (NEW!)
- 📋 Document templates for consistent formatting
- ⚙️ Configuration files for workflow automation
- 🔧 Command generation scripts for dynamic task commands
- 📖 CLAUDE.md with comprehensive workflow instructions
- Generates user stories and acceptance criteria
- Uses EARS format (WHEN/IF/THEN statements)
- Ensures comprehensive requirement coverage
- Creates technical architecture and design
- Includes Mermaid diagrams for visualization
- Plans components, interfaces, and data models
- Breaks design into atomic coding tasks
- References specific requirements
- Focuses on test-driven development
- Executes tasks systematically
- Validates against requirements
- Ensures quality and consistency
After setup, use these commands in Claude Code:
# Create a new feature spec
/spec-create user-authentication "Secure login system"
# Generate requirements document
/spec-requirements
# Create design document
/spec-design
# Generate implementation tasks
/spec-tasks
# Execute specific tasks (two ways):
/spec-execute 1 # Traditional way
/user-authentication-task-1 # New auto-generated command
# Execute subtasks
/user-authentication-task-2.1 # Auto-generated for subtasks
# Check status
/spec-status
# List all specs
/spec-list
The workflow now automatically creates individual commands for each task:
- Easier execution: /user-auth-task-1 instead of /spec-execute 1 user-authentication
- Better organization: Commands grouped by spec in .claude/commands/{spec-name}/
- Auto-completion: Claude Code can suggest spec-specific commands
- Clear purpose: Each command shows exactly what task it executes
# Setup in current directory
npx @pimzino/claude-code-spec-workflow
# Setup in specific directory
npx @pimzino/claude-code-spec-workflow --project /path/to/project
# Force overwrite existing files
npx @pimzino/claude-code-spec-workflow --force
# Skip confirmation prompts
npx @pimzino/claude-code-spec-workflow --yes
# Test the setup
npx @pimzino/claude-code-spec-workflow test
- Works out of the box with any project
- Auto-detects project type (Node.js, Python, Java, etc.)
- Validates Claude Code installation
- Beautiful CLI with progress indicators
- Confirmation prompts for safety
- Helpful error messages and guidance
- Preserves existing CLAUDE.md content
- Creates comprehensive directory structure
- Includes all necessary templates and configs
- TypeScript implementation
- Comprehensive error handling
- Follows npm best practices
your-project/
├── .claude/
│ ├── commands/
│ │ ├── spec-create.md
│ │ ├── spec-requirements.md
│ │ ├── spec-design.md
│ │ ├── spec-tasks.md
│ │ ├── spec-execute.md
│ │ ├── spec-status.md
│ │ ├── spec-list.md
│ │ └── {spec-name}/ # Auto-generated (NEW!)
│ │ ├── task-1.md
│ │ ├── task-2.md
│ │ └── task-2.1.md
│ ├── scripts/ # NEW!
│ │ ├── generate-commands.bat # Windows script
│ │ ├── generate-commands.sh # macOS/Linux script
│ │ ├── generate-commands-launcher.sh # OS detection launcher
│ │ └── README.md # Script documentation
│ ├── templates/
│ │ ├── requirements-template.md
│ │ ├── design-template.md
│ │ └── tasks-template.md
│ ├── specs/
│ │ └── (your specs will be created here)
│ └── spec-config.json
└── CLAUDE.md (created/updated)
The package includes a built-in test command:
# Test setup in temporary directory
npx @pimzino/claude-code-spec-workflow test
- Node.js 16.0.0 or higher
- Claude Code installed and configured
- Any project directory
❓ Command not found after NPX
# Make sure you're using the correct package name
npx @pimzino/claude-code-spec-workflow
❓ Setup fails with permission errors
# Try with different directory permissions
npx @pimzino/claude-code-spec-workflow --project ~/my-project
❓ Claude Code not detected
# Install Claude Code first
npm install -g @anthropic-ai/claude-code
# Show verbose output
DEBUG=* npx @pimzino/claude-code-spec-workflow
# Check package version
npx @pimzino/claude-code-spec-workflow --version
cd my-awesome-project
npx @pimzino/claude-code-spec-workflow
claude
# Type: /spec-create user-dashboard "User profile management"
# Setup multiple projects
for dir in project1 project2 project3; do
npx @pimzino/claude-code-spec-workflow --project $dir --yes
done
Contributions are welcome! Please see our Contributing Guide.
MIT License - see LICENSE for details.
See CHANGELOG.md for version history.
Transform your development workflow with automated spec-driven development! 🚀
Made with ❤️ by Pimzino
![The Perfect Router Does Not Exi [video]](https://www.youtube.com/img/desktop/supported_browsers/firefox.png)
