This project provides automated, spec-driven development workflows for Claude Code, targeting developers who want to structure their feature development and bug fixing processes. It streamlines the creation of new features through a Requirements → Design → Tasks → Implementation cycle and simplifies bug resolution via a Report → Analyze → Fix → Verify process, enhancing project consistency and efficiency.

How It Works

The tool sets up a .claude/ directory containing slash commands, steering documents (product, tech, structure), and templates for a structured development lifecycle. It leverages Claude Code's capabilities to generate requirements in EARS format, technical designs with Mermaid diagrams, and atomic coding tasks. Auto-generated task commands simplify execution, and a real-time dashboard visualizes progress and status.

Quick Start & Requirements

• Primary install/run command: npx @pimzino/claude-code-spec-workflow
• Prerequisites: Node.js 16.0.0+, Claude Code installed and configured.
• Setup time: Minimal, as it's an NPX command.
• Documentation: Claude Code Docs

Highlighted Details

• Implements spec-driven development for new features and a streamlined bug fix workflow.
• Features auto-generated task commands for easier execution and better organization.
• Includes a real-time web dashboard for monitoring specs and tasks, built with Tailwind CSS and petite-vue.
• Steering documents (product.md, tech.md, structure.md) provide persistent project context and standards.

Maintenance & Community

• Developed by Pimzino.
• Contributions are welcome via a Contributing Guide.
• Special thanks to @boundless-oss for steering documents and @mquinnv for the dashboard feature.

Licensing & Compatibility

• MIT License.
• Compatible with commercial use and closed-source linking.

Limitations & Caveats

The project requires Claude Code to be installed and configured separately. While it aims for zero configuration, specific project structures or permission issues might require troubleshooting.