claude-cto-team

# Claude Code Custom CTO Team - AI-Powered Technical Leadership Agents

[![GitHub stars](https://img.shields.io/github/stars/alirezarezvani/claude-cto-team?style=social)](https://github.com/alirezarezvani/claude-cto-team)
[![GitHub forks](https://img.shields.io/github/forks/alirezarezvani/claude-cto-team?style=social)](https://github.com/alirezarezvani/claude-cto-team/fork)
[![GitHub issues](https://img.shields.io/github/issues/alirezarezvani/claude-cto-team)](https://github.com/alirezarezvani/claude-cto-team/issues)
[![GitHub last commit](https://img.shields.io/github/last-commit/alirezarezvani/claude-cto-team)](https://github.com/alirezarezvani/claude-cto-team/commits/main)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blueviolet)](https://claude.ai/code)

> **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?](#why-use-claude-code-cto-team)
- [Quick Start Commands](#quick-start-commands)
- [The Three-Agent System](#the-three-agent-system)
- [Agent Capabilities](#agent-capabilities)
  - [cto-orchestrator](#cto-orchestrator-sonnet)
  - [cto-architect](#cto-architect-opus)
  - [strategic-cto-mentor](#strategic-cto-mentor-opus)
- [Slash Commands](#slash-commands)
- [Skills](#skills)
- [How the Agents Collaborate](#how-the-agents-collaborate)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage Examples](#usage-examples)
- [Author](#author)
- [Contributing](#contributing)
- [Support This Project](#support-this-project)
- [License](#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:**
1. Business Impact
2. Technical Risk
3. Operational Risk
4. Financial Risk
5. Timeline Risk
6. Team Risk
7. 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.

```bash
/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.

```bash
/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.

```bash
/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.

```bash
/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 |
| **scalabilit

[truncated…]