alirezarezvani/claude-cto-team

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:

The Three-Agent System

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.

/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)

Architect Skills (cto-architect)

Mentor Skills (strategic-cto-mentor)

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:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/new-agent)
3. Commit your changes (git commit -m 'Add new agent capability')
4. Push to the branch (git push origin feature/new-agent)
5. 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!