Skip to content
Back to search

claude-cto-team

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alirezarezvani--claude-cto-team/badge.svg)](/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

i

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)

  1. {
  2. "name": "cto-team-marketplace",
  3. "owner": {
  4. "name": "Alireza Rezvani",
  5. "email": "contact@alirezarezvani.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "cto-team",
  10. "source": {
  11. "source": "github",
  12. "repo": "alirezarezvani/claude-cto-team"
  13. },
  14. "description": "Strategic CTO advisory team with specialized agents for architecture design, plan validation, and technology decisions",
  15. "version": "1.0.0",
  16. "author": {
  17. "name": "Alireza Rezvani",
  18. "url": "https://github.com/alirezarezvani"
  19. },
  20. "homepage": "https://github.com/alirezarezvani/claude-cto-team",
  21. "repository": "https://github.com/alirezarezvani/claude-cto-team",
  22. "license": "MIT",
  23. "keywords": [
  24. "cto",
  25. "architecture",
  26. "strategic-planning",
  27. "tech-decisions",
  28. "validation",
  29. "roadmap",
  30. "build-vs-buy",
  31. "system-design",
  32. "ml-architecture"
  33. ],
  34. "category": "productivity"
  35. }
  36. ]
  37. }
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)

  1. # Claude Code Custom CTO Team - AI-Powered Technical Leadership Agents
  2. [![GitHub stars](https://img.shields.io/github/stars/alirezarezvani/claude-cto-team?style=social)](https://github.com/alirezarezvani/claude-cto-team)
  3. [![GitHub forks](https://img.shields.io/github/forks/alirezarezvani/claude-cto-team?style=social)](https://github.com/alirezarezvani/claude-cto-team/fork)
  4. [![GitHub issues](https://img.shields.io/github/issues/alirezarezvani/claude-cto-team)](https://github.com/alirezarezvani/claude-cto-team/issues)
  5. [![GitHub last commit](https://img.shields.io/github/last-commit/alirezarezvani/claude-cto-team)](https://github.com/alirezarezvani/claude-cto-team/commits/main)
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  7. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-blueviolet)](https://claude.ai/code)
  8. > **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.
  9. 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.
  10. ---
  11. ## Table of Contents
  12. - [Why Use Claude Code CTO Team?](#why-use-claude-code-cto-team)
  13. - [Quick Start Commands](#quick-start-commands)
  14. - [The Three-Agent System](#the-three-agent-system)
  15. - [Agent Capabilities](#agent-capabilities)
  16. - [cto-orchestrator](#cto-orchestrator-sonnet)
  17. - [cto-architect](#cto-architect-opus)
  18. - [strategic-cto-mentor](#strategic-cto-mentor-opus)
  19. - [Slash Commands](#slash-commands)
  20. - [Skills](#skills)
  21. - [How the Agents Collaborate](#how-the-agents-collaborate)
  22. - [Prerequisites](#prerequisites)
  23. - [Installation](#installation)
  24. - [Usage Examples](#usage-examples)
  25. - [Author](#author)
  26. - [Contributing](#contributing)
  27. - [Support This Project](#support-this-project)
  28. - [License](#license)
  29. ---
  30. ## Why Use Claude Code CTO Team?
  31. - **Strategic Technical Guidance**: Get CTO-level advice on architecture, technology stack, and implementation roadmaps
  32. - **Honest Feedback**: Receive ruthless validation of your plans before costly mistakes
  33. - **Multi-Domain Expertise**: ML/AI integration, cloud infrastructure, full-stack development, and scalability planning
  34. - **Faster Decision Making**: Route complex technical questions to the right specialist instantly
  35. ## Quick Start Commands
  36. Once installed, use these slash commands to instantly access CTO-level guidance:
  37. | Command | What It Does | Example |
  38. |---------|--------------|---------|
  39. | `/validate` | Ruthlessly validate your plans | `/validate my Q2 roadmap` |
  40. | `/design` | Design system architecture | `/design notification system for 100K users` |
  41. | `/decide` | Get help with build vs buy decisions | `/decide should we use Auth0 or build custom auth` |
  42. | `/cto` | General CTO guidance | `/cto our app is slow, users complaining` |
  43. ## The Three-Agent System
  44. | Agent | Role | Best For |
  45. |-------|------|----------|
  46. | **cto-orchestrator** | Coordinator & Router | Vague requirements, multi-domain projects, unclear where to start |
  47. | **cto-architect** | System Designer | New architecture, "How should I build X?", technology decisions, roadmaps |
  48. | **strategic-cto-mentor** | Ruthless Validator | Validating plans, build vs buy, prioritization, need honest feedback |
  49. ## Agent Capabilities
  50. ### cto-orchestrator (Sonnet)
  51. The intelligent entry point for complex technical requests. Challenges vague buzzwords, clarifies requirements, and routes work to the right specialist.
  52. **Example triggers:**
  53. - "I want to add AI capabilities to my app"
  54. - "Here's my Q2 roadmap, what do you think?"
  55. - "Our app is slow and users are complaining"
  56. ### cto-architect (Opus)
  57. Designs comprehensive system architectures and implementation roadmaps with 15+ years of simulated experience in scalable web/mobile applications with ML/AI integration.
  58. **Core expertise:**
  59. - **Full-stack**: React, NextJS, Node.js, React Native, Swift, Kotlin
  60. - **Backend**: Microservices, PostgreSQL, GraphQL, REST APIs
  61. - **ML/AI**: Real-time CV pipelines, model serving, vector databases, RAG systems
  62. - **Infrastructure**: Kubernetes, Docker, AWS/GCP, multi-region deployments
  63. **Deliverables:**
  64. - Executive summary with budget estimates
  65. - System architecture with component diagrams
  66. - Technology stack with explicit trade-off analysis
  67. - Phased implementation roadmap with validation checkpoints
  68. - Risk assessment and mitigation strategies
  69. ### strategic-cto-mentor (Opus)
  70. 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.
  71. **Seven-Dimension Evaluation Framework:**
  72. 1. Business Impact
  73. 2. Technical Risk
  74. 3. Operational Risk
  75. 4. Financial Risk
  76. 5. Timeline Risk
  77. 6. Team Risk
  78. 7. Market Risk
  79. **Anti-patterns Identified:**
  80. - Premature Optimization Trap
  81. - Shiny Object Syndrome
  82. - Technical Debt Denial
  83. - Consensus Paralysis
  84. - Hero Culture
  85. - Build Trap
  86. - Timeline Fantasy
  87. ## How the Agents Collaborate
  88. ```
  89. User Request
  90. │
  91. ▼
  92. ┌─────────────────────────────────────────┐
  93. │ cto-orchestrator │
  94. │ Clarifies → Challenges → Routes │
  95. └────────────────┬────────────────────────┘
  96. │
  97. ┌────────────┴────────────┐
  98. ▼ ▼
  99. ┌───────────────┐ ┌─────────────────────┐
  100. │ cto-architect │ │ strategic-cto-mentor│
  101. │ (Design) │───▶│ (Validate) │
  102. └───────────────┘ └─────────────────────┘
  103. ```
  104. **Design → Validate**: Architect creates design, mentor stress-tests it
  105. **Validate → Design**: Mentor identifies flaws, architect revises
  106. ## Slash Commands
  107. The CTO Team includes **4 custom slash commands** for quick access to common CTO workflows:
  108. ### `/validate` - Strategic Validation
  109. Ruthlessly validate plans, roadmaps, or proposals before committing resources.
  110. ```bash
  111. /validate my Q2 roadmap: migrate to microservices, add real-time features, launch mobile app
  112. ```
  113. **Output**: 8-section validation report with verdict (GOOD / NEEDS MAJOR WORK / BAD), critical flaws, blindspots, and concrete next steps.
  114. ### `/design` - Architecture Design
  115. Design comprehensive system architecture with technology recommendations.
  116. ```bash
  117. /design real-time notification system for e-commerce platform with 100K users
  118. ```
  119. **Output**: Executive summary, system architecture, technology stack with trade-offs, implementation roadmap, risk assessment.
  120. ### `/decide` - Strategic Decisions
  121. Get help with build vs buy, technology choices, and prioritization dilemmas.
  122. ```bash
  123. /decide should we use OpenAI API or host our own LLM for customer support chatbot
  124. ```
  125. **Output**: Decision framework, TCO analysis, risk assessment, clear recommendation with rationale.
  126. ### `/cto` - General Guidance
  127. General CTO-level guidance for complex or vague requests.
  128. ```bash
  129. /cto we want to add AI capabilities to improve customer retention
  130. ```
  131. **Output**: Clarifying questions, routed to appropriate specialist, structured recommendations.
  132. ## Skills
  133. The CTO Team includes **12 specialized skills** that enhance agent capabilities:
  134. ### Orchestrator Skills (cto-orchestrator)
  135. | Skill | Purpose |
  136. |-------|---------|
  137. | **request-analyzer** | Classifies requests, detects vagueness, suggests routing |
  138. | **clarification-protocol** | Generates targeted clarifying questions |
  139. | **delegation-prompt-crafter** | Creates structured prompts for specialist agents |
  140. | **cost-estimator** | Infrastructure and development cost estimation |
  141. ### Architect Skills (cto-architect)
  142. | Skill | Purpose |
  143. |-------|---------|
  144. | **architecture-pattern-selector** | Select between Monolith, Microservices, Serverless |
  145. | **roadmap-generator** | Phased implementation plans with Epic/Story breakdown |
  146. | **tech-stack-recommender** | Technology stack selection by project type |
  147. | **scalability-advisor** | Scaling stages and capacity planning |
  148. | **ml-cv-specialist** | ML system design and model selection |
  149. ### Mentor Skills (strategic-cto-mentor)
  150. | Skill | Purpose |
  151. |-------|---------|
  152. | **assumption-challenger** | Stress-test implicit assumptions in plans |
  153. | **antipattern-detector** | Detect common failure patterns |
  154. | **validation-report-generator** | 8-section validation reports with verdicts |
  155. Skills are automatically discovered and used by agents based on context.
  156. ## Prerequisites
  157. Before installing the CTO Team plugin, ensure you have:
  158. - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and configured
  159. - An active Anthropic API key or Claude Pro/Max subscription
  160. ## Installation
  161. ### Option 1: Plugin Install (Recommended)
  162. Install directly from GitHub with a single command:
  163. ```bash
  164. claude /plugin install alirezarezvani/claude-cto-team
  165. ```
  166. This installs agents, slash commands, and skills globally - available in all your projects!
  167. ### Option 2: Clone to Project
  168. If you prefer project-specific installation:
  169. ```bash
  170. # Clone the repository
  171. git clone https://github.com/alirezarezvani/claude-cto-team.git
  172. # Copy the plugin components to your project's .claude folder
  173. cp -r claude-cto-team/agents /path/to/your/project/.claude/
  174. cp -r claude-cto-team/commands /path/to/your/project/.claude/
  175. cp -r claude-cto-team/skills /path/to/your/project/.claude/
  176. ```
  177. ### Plugin Structure
  178. ```
  179. claude-cto-team/
  180. ├── .claude-plugin/
  181. │ └── plugin.json # Plugin manifest
  182. ├── agents/ # AI subagents
  183. │ ├── cto-architect.md
  184. │ ├── cto-orchestrator.md
  185. │ └── strategic-cto-mentor.md
  186. ├── commands/ # Slash commands
  187. │ ├── cto.md
  188. │ ├── decide.md
  189. │ ├── design.md
  190. │ └── validate.md
  191. └── skills/ # Agent skills
  192. ├── architecture-pattern-selector/
  193. ├── assumption-challenger/
  194. ├── antipattern-detector/
  195. ├── clarification-protocol/
  196. ├── cost-estimator/
  197. ├── delegation-prompt-crafter/
  198. ├── ml-cv-specialist/
  199. ├── request-analyzer/
  200. ├── roadmap-generator/
  201. ├── scalability-advisor/
  202. ├── tech-stack-recommender/
  203. └── validation-report-generator/
  204. ```
  205. The agents and commands are automatically available in Claude Code after installation.
  206. ## Usage Examples
  207. ### Architecture Design Request
  208. > "I want to build a mobile app that uses computer vision to identify plants. We expect 100K users in the first year."
  209. → Routes to **cto-architect** for comprehensive architecture design with ML pipeline recommendations
  210. ### Strategic Plan Validation
  211. > "Here's my draft Q2 roadmap: migrate to Kubernetes, implement real-time features, refactor payments, launch mobile app."
  212. → Routes to **strategic-cto-mentor** for ruthless stress-testing and timeline reality check
  213. ### Build vs Buy Decision
  214. > "Should we use OpenAI's API or host our own LLM? We're processing 50K conversations per month."
  215. → Routes to **strategic-cto-mentor** for TCO analysis and trade-off evaluation
  216. ## Author
  217. **Alireza Rezvani**
  218. [![Website](https://img.shields.io/badge/Website-alirezarezvani.com-blue)](https://alirezarezvani.com)
  219. [![LinkedIn](https://img.shields.io/badge/LinkedIn-alirezarezvani-0077B5?logo=linkedin)](https://www.linkedin.com/in/alirezarezvani/)
  220. [![Medium](https://img.shields.io/badge/Medium-@alirezarezvani-12100E?logo=medium)](https://alirezarezvani.medium.com/)
  221. - Website: [alirezarezvani.com](https://alirezarezvani.com)
  222. - LinkedIn: [linkedin.com/in/alirezarezvani](https://www.linkedin.com/in/alirezarezvani/)
  223. - Medium: [alirezarezvani.medium.com](https://alirezarezvani.medium.com/)
  224. ## Contributing
  225. Contributions are welcome! If you have ideas for improving these agents or want to add new capabilities:
  226. 1. Fork the repository
  227. 2. Create your feature branch (`git checkout -b feature/new-agent`)
  228. 3. Commit your changes (`git commit -m 'Add new agent capability'`)
  229. 4. Push to the branch (`git push origin feature/new-agent`)
  230. 5. Open a Pull Request
  231. ## Support This Project
  232. If this project saved you time or helped you make better technical decisions, consider supporting its continued development:
  233. [![Buy me a book](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20book&emoji=📖&slug=rezarezvani&button_colour=40DCA5&font_colour=ffffff&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00)](https://www.buymeacoffee.com/rezarezvani)
  234. A star on GitHub also helps others discover this project:
  235. [![Star this repo](https://img.shields.io/github/stars/alirezarezvani/claude-cto-team?style=social)](https://github.com/alirezarezvani/claude-cto-team)
  236. ## License
  237. MIT License - [Alireza Rezvani](https://alirezarezvani.com)
  238. ---
  239. **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 in

Free to use. If it’s helped, pass it on.