🤖 AI-powered software development lifecycle management system deeply integrated with Claude Code
Claude Code GPT-Pilot is an intelligent software development system that leverages Claude Code's capabilities to manage the entire software development lifecycle. It provides a structured workflow with specialized AI agents, automated task management, and seamless integration with your development environment.
- 🎭 7 Specialized AI Agents - Product Owner, Architect, Tech Lead, Developer, Tester, Reviewer, Debugger
- 🔄 Dual Development Modes - Manual step-by-step or fully automated batch execution
- 📋 Smart Task Management - Automatic dependency checking and task orchestration
- 🧪 TDD-First Approach - Built-in Test-Driven Development workflow
- 📊 Progress Tracking - Real-time task status and completion tracking
- 🚀 Quick Setup - Initialize projects with a single command
- 📝 Rich Documentation - Comprehensive templates and examples
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ CLAUDE.md │ │
│ │ (Smart Convention System - Command Recognition) │ │
│ └───────────────────────────────────────────────────────┘ │
│ │ │
│ ┌────────────────────────┴──────────────────────────────┐ │
│ │ 7 Specialized Agents │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ Product │ │Architect │ │Tech Lead │ │Developer │ │ │
│ │ │ Owner │ │ │ │ │ │ │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ Tester │ │ Reviewer │ │ Debugger │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ └───────────────────────────────────────────────────────┘ │
│ │ │
│ ┌────────────────────────┴──────────────────────────────┐ │
│ │ Task Management System │ │
│ │ - task.js (Dependency checking & orchestration) │ │
│ │ - task_status.json (Task state tracking) │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
# Install globally via npm
npm install -g claudecode-gpt
# Or clone and link locally
git clone https://github.com/yourusername/claudecode-pilot.git
cd claudecode-pilot
npm install
npm link# Create a new project
mkdir my-awesome-project
cd my-awesome-project
# Initialize Claude Code GPT-Pilot
claudecode-gpt init --name "My Awesome Project"This will create:
my-awesome-project/
├── .claude-pilot/ # GPT-Pilot system files
│ ├── agents/ # Agent configurations
│ ├── templates/ # 7 Agent templates
│ ├── tools/ # Task management tools
│ └── context_memory.json # Context storage
├── docs/ # Documentation
├── src/ # Source code
├── tests/ # Test files
├── CLAUDE.md # Command definitions
└── README.md # Project README
-
Open the project in Claude Code
-
Start with Product Owner to define requirements:
/product-owner -
Design the architecture:
/architect -
Break down into tasks:
/tech-lead -
Start development (manual mode):
/developer T001 -
Or use automated mode:
/developer-auto
Role: Requirements gathering and product definition
Command: /product-owner
Output: product_requirements.md
Helps you define clear requirements, user stories, and acceptance criteria.
Role: System architecture and technology selection
Command: /architect
Output: architecture.md, project initialization scripts
Designs the system architecture and selects the optimal technology stack.
Role: Task breakdown and planning
Command: /tech-lead
Output: tasks.md, task_status.json
Breaks down the project into manageable tasks with clear dependencies.
Role: Feature implementation using TDD Commands:
/developer [taskId]- Manual mode (step-by-step)/developer-auto [taskId]- Automated mode (batch execution)
Implements features following a strict TDD 5-phase workflow.
Role: Test strategy and test case design
Command: /tester [taskId]
Output: Test files, test reports
Creates comprehensive test suites and ensures quality.
Role: Code review and quality assurance
Command: /reviewer [taskId]
Output: Review reports, improvement suggestions
Performs thorough code reviews and ensures best practices.
Role: Problem diagnosis and debugging
Command: /debugger "error description"
Output: Debug reports, fix suggestions
Systematically diagnoses and fixes issues.
# Initialize a new project
claudecode-gpt init --name "Project Name" [--dir ./path]
# Show version
claudecode-gpt --version
# Show help
claudecode-gpt --help# Show next executable task
node .claude-pilot/tools/task.js next
# List all tasks
node .claude-pilot/tools/task.js list [status]
# Check task dependencies
node .claude-pilot/tools/task.js check <taskId>
# Update task status
node .claude-pilot/tools/task.js update <taskId> <status>
# Show all executable tasks
node .claude-pilot/tools/task.js executable
# Show help
node .claude-pilot/tools/task.js help/product-owner - Define product requirements
/architect - Design system architecture
/tech-lead - Break down tasks
/developer <taskId> - Implement task (manual mode)
/developer-auto [taskId] - Implement tasks (auto mode)
/tester <taskId> - Write tests
/reviewer <taskId> - Review code
/debugger "<error>" - Debug issues
/next-task - Show next task
/task-list - Show all tasks
/status - Show project status
/help - Show help
After initialization, your project will have:
your-project/
├── .claude-pilot/
│ ├── agents/
│ │ └── agents.json # Agent configurations
│ ├── templates/
│ │ ├── product-owner.md # Product Owner template
│ │ ├── architect.md # Architect template
│ │ ├── tech-lead.md # Tech Lead template
│ │ ├── developer.md # Developer template (with task.js guide)
│ │ ├── tester.md # Tester template
│ │ ├── reviewer.md # Reviewer template
│ │ └── debugger.md # Debugger template
│ ├── tools/
│ │ └── task.js # Task management tool (auto-copied)
│ ├── context_memory.json # Context storage
│ └── README.md # System README
├── docs/
│ ├── product_requirements.md # Generated by Product Owner
│ ├── architecture.md # Generated by Architect
│ └── ...
├── src/ # Your source code
├── tests/ # Your tests
├── tasks.md # Generated by Tech Lead
├── task_status.json # Task tracking file
├── CLAUDE.md # Command definitions
└── README.md # Your project README
Check out the complete example project in examples/sample-project/:
- Pomodoro Timer Application - A full-featured example
- 10 tasks with complex dependencies
- Complete documentation (requirements, architecture, tasks)
- Ready to use with
/developer-auto
cd examples/sample-project
node ../../.claude-pilot/tools/task.js list- User Guide - Detailed usage instructions
- Test Report - System test results
- Example Project - Complete example
Contributions are welcome! Please feel free to submit a Pull Request.
git clone https://github.com/yourusername/claudecode-pilot.git
cd claudecode-pilot
npm install
npm linkPlease use the GitHub Issues page to report bugs or request features.
MIT License - see the LICENSE file for details.
- Built for Claude Code by Anthropic
- Inspired by GPT-Pilot
- Uses Test-Driven Development (TDD) methodology
Made with ❤️ for developers who love AI-assisted coding