claude-cto-team
Your personal CTO Team for Claude Code . These Subagents will help you challenging yourself while you plan and execute.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/alirezarezvani--claude-cto-team)HTML
<a href="/listings/alirezarezvani--claude-cto-team"><img src="/api/listings/alirezarezvani--claude-cto-team/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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` |
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 37 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "cto-team-marketplace",
- "owner": {
- "name": "Alireza Rezvani",
- "email": "contact@alirezarezvani.com"
- },
- "plugins": [
- {
- "name": "cto-team",
- "source": {
- "source": "github",
- "repo": "alirezarezvani/claude-cto-team"
- },
- "description": "Strategic CTO advisory team with specialized agents for architecture design, plan validation, and technology decisions",
- "version": "1.0.0",
- "author": {
- "name": "Alireza Rezvani",
- "url": "https://github.com/alirezarezvani"
- },
- "homepage": "https://github.com/alirezarezvani/claude-cto-team",
- "repository": "https://github.com/alirezarezvani/claude-cto-team",
- "license": "MIT",
- "keywords": [
- "cto",
- "architecture",
- "strategic-planning",
- "tech-decisions",
- "validation",
- "roadmap",
- "build-vs-buy",
- "system-design",
- "ml-architecture"
- ],
- "category": "productivity"
- }
- ]
- }
README.md · README · 326 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Claude Code Custom CTO Team - AI-Powered Technical Leadership Agents
- [](https://github.com/alirezarezvani/claude-cto-team)
- [](https://github.com/alirezarezvani/claude-cto-team/fork)
- [](https://github.com/alirezarezvani/claude-cto-team/issues)
- [](https://github.com/alirezarezvani/claude-cto-team/commits/main)
- [](https://opensource.org/licenses/MIT)
- [](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 |
- | **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](https://docs.anthropic.com/en/docs/claude-code) 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:
- ```bash
- 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:
- ```bash
- # 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**
- [](https://alirezarezvani.com)
- [](https://www.linkedin.com/in/alirezarezvani/)
- [](https://alirezarezvani.medium.com/)
- - Website: [alirezarezvani.com](https://alirezarezvani.com)
- - LinkedIn: [linkedin.com/in/alirezarezvani](https://www.linkedin.com/in/alirezarezvani/)
- - Medium: [alirezarezvani.medium.com](https://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:
- [](https://www.buymeacoffee.com/rezarezvani)
- A star on GitHub also helps others discover this project:
- [](https://github.com/alirezarezvani/claude-cto-team)
- ## License
- MIT License - [Alireza Rezvani](https://alirezarezvani.com)
- ---
- **Found this useful?** Share it with your network and help others discover AI-powered technical leadership for Claude Code!
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.