Claude Code Custom CTO Team - AI-Powered Technical Leadership Agents
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.
Table of Contents
- Why Use Claude Code CTO Team?
- Quick Start Commands
- The Three-Agent System
- Agent Capabilities
- cto-orchestrator
- cto-architect
- strategic-cto-mentor
- Slash Commands
- Skills
- How the Agents Collaborate
- Prerequisites
- Installation
- Usage Examples
- Author
- Contributing
- Support This Project
- License
Why Use Claude Code CTO Team?
- 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
Quick Start Commands
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 |
The Three-Agent System
| 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 |
Agent Capabilities
cto-orchestrator (Sonnet)
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"
cto-architect (Opus)
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
strategic-cto-mentor (Opus)
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
How the Agents Collaborate
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
Slash Commands
The CTO Team includes 4 custom slash commands for quick access to common CTO workflows:
/validate - Strategic Validation
Ruthlessly validate plans, roadmaps, or proposals before committing resources.
/validate my Q2 roadmap: migrate to microservices, add real-time features, launch mobile app
Output: 8-section validation report with verdict (GOOD / NEEDS MAJOR WORK / BAD), critical flaws, blindspots, and concrete next steps.
/design - Architecture Design
Design comprehensive system architecture with technology recommendations.
/design real-time notification system for e-commerce platform with 100K users
Output: Executive summary, system architecture, technology stack with trade-offs, implementation roadmap, risk assessment.
/decide - Strategic Decisions
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 chatbot
Output: Decision framework, TCO analysis, risk assessment, clear recommendation with rationale.
/cto - General Guidance
General CTO-level guidance for complex or vague requests.
/cto we want to add AI capabilities to improve customer retention
Output: Clarifying questions, routed to appropriate specialist, structured recommendations.
Skills
The CTO Team includes 12 specialized skills that enhance agent capabilities:
Orchestrator Skills (cto-orchestrator)
| 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 |
Architect Skills (cto-architect)
| 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 |
Mentor Skills (strategic-cto-mentor)
| 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.
Prerequisites
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
Installation
Option 1: Plugin Install (Recommended)
Install directly from GitHub with a single command:
claude /plugin install alirezarezvani/claude-cto-team
This installs agents, slash commands, and skills globally - available in all your projects!
Option 2: Clone to Project
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/
Plugin Structure
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.
Usage Examples
Architecture Design Request
"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
Strategic Plan Validation
"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
Build vs Buy Decision
"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
Author
Alireza Rezvani
- Website: alirezarezvani.com
- LinkedIn: linkedin.com/in/alirezarezvani
- Medium: alirezarezvani.medium.com
Contributing
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
Support This Project
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:
License
MIT License - Alireza Rezvani
Found this useful? Share it with your network and help others discover AI-powered technical leadership for Claude Code!
