Your personal CTO Team for Claude Code - Custom AI subagents that provide strategic technical leadership, system architecture design, and brutally honest feedback on your technical decisions.
Transform how you plan and execute software projects with three specialized AI agents that challenge your thinking, design scalable architectures, and validate your roadmaps before you commit resources.
- Why Use Claude Code CTO Team?
- Quick Start Commands
- The Three-Agent System
- Agent Capabilities
- Slash Commands
- Skills
- How the Agents Collaborate
- Prerequisites
- Installation
- Usage Examples
- Author
- Contributing
- Support This Project
- License
- Strategic Technical Guidance: Get CTO-level advice on architecture, technology stack, and implementation roadmaps
- Honest Feedback: Receive ruthless validation of your plans before costly mistakes
- Multi-Domain Expertise: ML/AI integration, cloud infrastructure, full-stack development, and scalability planning
- Faster Decision Making: Route complex technical questions to the right specialist instantly
Once installed, use these slash commands to instantly access CTO-level guidance:
| Command | What It Does | Example |
|---|---|---|
/validate |
Ruthlessly validate your plans | /validate my Q2 roadmap |
/design |
Design system architecture | /design notification system for 100K users |
/decide |
Get help with build vs buy decisions | /decide should we use Auth0 or build custom auth |
/cto |
General CTO guidance | /cto our app is slow, users complaining |
| Agent | Role | Best For |
|---|---|---|
| cto-orchestrator | Coordinator & Router | Vague requirements, multi-domain projects, unclear where to start |
| cto-architect | System Designer | New architecture, "How should I build X?", technology decisions, roadmaps |
| strategic-cto-mentor | Ruthless Validator | Validating plans, build vs buy, prioritization, need honest feedback |
The intelligent entry point for complex technical requests. Challenges vague buzzwords, clarifies requirements, and routes work to the right specialist.
Example triggers:
- "I want to add AI capabilities to my app"
- "Here's my Q2 roadmap, what do you think?"
- "Our app is slow and users are complaining"
Designs comprehensive system architectures and implementation roadmaps with 15+ years of simulated experience in scalable web/mobile applications with ML/AI integration.
Core expertise:
- Full-stack: React, NextJS, Node.js, React Native, Swift, Kotlin
- Backend: Microservices, PostgreSQL, GraphQL, REST APIs
- ML/AI: Real-time CV pipelines, model serving, vector databases, RAG systems
- Infrastructure: Kubernetes, Docker, AWS/GCP, multi-region deployments
Deliverables:
- Executive summary with budget estimates
- System architecture with component diagrams
- Technology stack with explicit trade-off analysis
- Phased implementation roadmap with validation checkpoints
- Risk assessment and mitigation strategies
Ruthless CTO mentor who stress-tests your ideas until they're bulletproof. Simulates 20+ years of experience with hard lessons from both failed and successful ventures.
Seven-Dimension Evaluation Framework:
- Business Impact
- Technical Risk
- Operational Risk
- Financial Risk
- Timeline Risk
- Team Risk
- Market Risk
Anti-patterns Identified:
- Premature Optimization Trap
- Shiny Object Syndrome
- Technical Debt Denial
- Consensus Paralysis
- Hero Culture
- Build Trap
- Timeline Fantasy
User Request
│
▼
┌─────────────────────────────────────────┐
│ cto-orchestrator │
│ Clarifies → Challenges → Routes │
└────────────────┬────────────────────────┘
│
┌────────────┴────────────┐
▼ ▼
┌───────────────┐ ┌─────────────────────┐
│ cto-architect │ │ strategic-cto-mentor│
│ (Design) │───▶│ (Validate) │
└───────────────┘ └─────────────────────┘
Design → Validate: Architect creates design, mentor stress-tests it Validate → Design: Mentor identifies flaws, architect revises
The CTO Team includes 4 custom slash commands for quick access to common CTO workflows:
Ruthlessly validate plans, roadmaps, or proposals before committing resources.
/validate my Q2 roadmap: migrate to microservices, add real-time features, launch mobile appOutput: 8-section validation report with verdict (GOOD / NEEDS MAJOR WORK / BAD), critical flaws, blindspots, and concrete next steps.
Design comprehensive system architecture with technology recommendations.
/design real-time notification system for e-commerce platform with 100K usersOutput: Executive summary, system architecture, technology stack with trade-offs, implementation roadmap, risk assessment.
Get help with build vs buy, technology choices, and prioritization dilemmas.
/decide should we use OpenAI API or host our own LLM for customer support chatbotOutput: Decision framework, TCO analysis, risk assessment, clear recommendation with rationale.
General CTO-level guidance for complex or vague requests.
/cto we want to add AI capabilities to improve customer retentionOutput: Clarifying questions, routed to appropriate specialist, structured recommendations.
The CTO Team includes 12 specialized skills that enhance agent capabilities:
| Skill | Purpose |
|---|---|
| request-analyzer | Classifies requests, detects vagueness, suggests routing |
| clarification-protocol | Generates targeted clarifying questions |
| delegation-prompt-crafter | Creates structured prompts for specialist agents |
| cost-estimator | Infrastructure and development cost estimation |
| Skill | Purpose |
|---|---|
| architecture-pattern-selector | Select between Monolith, Microservices, Serverless |
| roadmap-generator | Phased implementation plans with Epic/Story breakdown |
| tech-stack-recommender | Technology stack selection by project type |
| scalability-advisor | Scaling stages and capacity planning |
| ml-cv-specialist | ML system design and model selection |
| Skill | Purpose |
|---|---|
| assumption-challenger | Stress-test implicit assumptions in plans |
| antipattern-detector | Detect common failure patterns |
| validation-report-generator | 8-section validation reports with verdicts |
Skills are automatically discovered and used by agents based on context.
Before installing the CTO Team plugin, ensure you have:
- Claude Code CLI installed and configured
- An active Anthropic API key or Claude Pro/Max subscription
Install directly from GitHub with a single command:
claude /plugin install alirezarezvani/claude-cto-teamThis installs agents, slash commands, and skills globally - available in all your projects!
If you prefer project-specific installation:
# Clone the repository
git clone https://github.com/alirezarezvani/claude-cto-team.git
# Copy the plugin components to your project's .claude folder
cp -r claude-cto-team/agents /path/to/your/project/.claude/
cp -r claude-cto-team/commands /path/to/your/project/.claude/
cp -r claude-cto-team/skills /path/to/your/project/.claude/claude-cto-team/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── agents/ # AI subagents
│ ├── cto-architect.md
│ ├── cto-orchestrator.md
│ └── strategic-cto-mentor.md
├── commands/ # Slash commands
│ ├── cto.md
│ ├── decide.md
│ ├── design.md
│ └── validate.md
└── skills/ # Agent skills
├── architecture-pattern-selector/
├── assumption-challenger/
├── antipattern-detector/
├── clarification-protocol/
├── cost-estimator/
├── delegation-prompt-crafter/
├── ml-cv-specialist/
├── request-analyzer/
├── roadmap-generator/
├── scalability-advisor/
├── tech-stack-recommender/
└── validation-report-generator/
The agents and commands are automatically available in Claude Code after installation.
"I want to build a mobile app that uses computer vision to identify plants. We expect 100K users in the first year."
→ Routes to cto-architect for comprehensive architecture design with ML pipeline recommendations
"Here's my draft Q2 roadmap: migrate to Kubernetes, implement real-time features, refactor payments, launch mobile app."
→ Routes to strategic-cto-mentor for ruthless stress-testing and timeline reality check
"Should we use OpenAI's API or host our own LLM? We're processing 50K conversations per month."
→ Routes to strategic-cto-mentor for TCO analysis and trade-off evaluation
Alireza Rezvani
- Website: alirezarezvani.com
- LinkedIn: linkedin.com/in/alirezarezvani
- Medium: alirezarezvani.medium.com
Contributions are welcome! If you have ideas for improving these agents or want to add new capabilities:
- Fork the repository
- Create your feature branch (
git checkout -b feature/new-agent) - Commit your changes (
git commit -m 'Add new agent capability') - Push to the branch (
git push origin feature/new-agent) - Open a Pull Request
If this project saved you time or helped you make better technical decisions, consider supporting its continued development:
A star on GitHub also helps others discover this project:
MIT License - Alireza Rezvani
Found this useful? Share it with your network and help others discover AI-powered technical leadership for Claude Code!
