Agent skill

Cto Plan Reviewer

by Ibrahim-3d in Ibrahim-3d/orchestrator-supaconductor

Technical architecture review agent for execution plans. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

AGPL-3.0Auto-check passedDevelopment

Install Cto Plan Reviewer

skills CLI
$ npx skills add Ibrahim-3d/orchestrator-supaconductor --skill cto-plan-reviewer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Ibrahim-3d/orchestrator-supaconductor cto-plan-reviewer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Ibrahim-3d/orchestrator-supaconductor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cto-plan-reviewer .claude/skills/cto-plan-reviewer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cto-plan-reviewer
GitHub stars
381
Token cost
~2.9k tokens
SKILL.md length
684 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Technical architecture review agent for execution plans. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

  • Works in 8 steps: Architecture Review → Tech Debt Assessment → Technology Evaluation → …
  • Tasks that involve Software architecture
  • SKILL.md covers When to Use, Inputs Required, Review Framework and Review Process, plus 5 more sections
  • Calls claude

What it does

Cto Plan Reviewer is an agent skill from Ibrahim-3d/orchestrator-supaconductor. Technical architecture review agent for execution plans. Uses cto-advisor skill to evaluate technical decisions, architecture patterns, tech debt implications, and technology choices in plan.md. Triggered by: 'review technical plan', 'cto review', 'architecture review', or automatically during Step 2 (Evaluate Plan) for tracks involving architecture decisions, integrations, or infrastructure changes.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Software architecture and Technical debt. The repository describes itself as: Multi-agent orchestration system for Claude Code with parallel execution, automated quality gates, Board of Directors, and bundled Superpowers skills. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Software architecture
  • Tasks that involve Technical debt

Example prompts

  • “review technical plan”
  • “cto review”
  • “architecture review”
  • “/cto-plan-reviewer”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Architecture Review
  2. Tech Debt Assessment
  3. Technology Evaluation
  4. Engineering Excellence
  5. Team & Process
  6. Load Context
  7. Invoke CTO Advisor Frameworks
  8. Generate Technical Review Report

What it can do on your machine

Read from SKILL.md and the folder at commit 76c9b10. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cto Plan Reviewer loads about 2.9k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 684 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Ibrahim-3d/orchestrator-supaconductor at commit 76c9b10, republished under its AGPL-3.0 licence (© Ibrahim-3d). 684 words, ~2,920 tokens.

Download SKILL.mdSave it as .claude/skills/cto-plan-reviewer/SKILL.md (or your agent's skills folder).
name
cto-plan-reviewer
description
Technical architecture review agent for execution plans. Uses cto-advisor skill to evaluate technical decisions, architecture patterns, tech debt implications, and technology choices in plan.md. Triggered by: 'review technical plan', 'cto review', 'architecture review', or automatically during Step 2 (Evaluate Plan) for tracks involving architecture decisions, integrations, or infrastructure changes.

CTO Plan Reviewer -- Technical Architecture Review

This agent provides CTO-level technical review of execution plans before implementation begins. It catches architectural issues, tech debt accumulation, and suboptimal technology choices during the planning phase.

When to Use

Automatically invoked during Step 2: EVALUATE PLAN when the track involves:

  • Architecture decisions or changes
  • Technology selection or integration
  • Infrastructure setup or changes
  • Database schema or migrations
  • API design or contracts
  • Scalability or performance concerns
  • Security-critical implementations

Also manually invocable via:

bash
claude /cto-advisor

Inputs Required

  1. Track's plan.md -- execution plan to review
  2. Track's spec.md -- requirements and context
  3. conductor/tech-stack.md -- current technology decisions
  4. conductor/product.md -- product requirements and constraints
  5. Codebase state -- existing architecture patterns

Review Framework

The agent leverages the cto-advisor skill to perform deep technical analysis across multiple dimensions:

1. Architecture Review
CheckUses CTO Advisor For
Architecture patternsEvaluate proposed patterns against team topologies, scalability needs
Design decisionsADR template guidance, decision documentation quality
System designComponent boundaries, separation of concerns, modularity
Technology standardsAlignment with existing stack, consistency

CTO Advisor Frameworks Used:

  • Architecture Decision Records (ADRs)
  • System Design Review checklist
  • Technology Standards evaluation
2. Tech Debt Assessment
CheckUses CTO Advisor For
Debt introductionWill this plan create technical debt? Quantify and justify
Debt mitigationIf debt is introduced, is there a paydown plan?
Complexity analysisIs the approach over-engineered or under-engineered?
Maintenance burdenLong-term ownership and maintenance implications

CTO Advisor Tools Used:

  • Tech Debt Analyzer framework
  • Tech Debt Strategy (40/25/15 allocation)
  • Red flags checklist
3. Technology Evaluation
CheckUses CTO Advisor For
Technology choicesAre new libraries/services necessary and well-justified?
Vendor dependenciesLock-in risk, SLA monitoring, cost implications
Integration complexityAPI design, error handling, retry logic
Cost implicationsInfrastructure costs, API usage costs, scaling costs

CTO Advisor Frameworks Used:

  • Technology Evaluation Framework (4-week process)
  • Vendor Management checklist
  • Cost optimization principles
4. Engineering Excellence
CheckUses CTO Advisor For
Testing strategyCoverage targets, test types, TDD applicability
Performance criteriaLoad requirements, optimization strategy
Security reviewOWASP top 10, input validation, auth patterns
ObservabilityMonitoring, logging, alerting, debugging

CTO Advisor Metrics Used:

  • DORA Metrics targets (deployment frequency, lead time, MTTR, CFR)
  • Quality Metrics (test coverage >80%, code review 100%, tech debt <10%)
  • Success Indicators checklist
5. Team & Process
CheckUses CTO Advisor For
Complexity appropriatenessCan the team execute this plan effectively?
Knowledge distributionSingle points of failure in knowledge?
Onboarding impactWill this make onboarding harder?
Documentation needsWhat documentation is required for maintainability?

CTO Advisor Principles Used:

  • Team Topologies
  • Engineering metrics (sprint velocity, unplanned work <20%)
  • Communication templates
Show full SKILL.md (267 more words)Show less

Review Process

Step 1: Load Context

Use context-loader skill to efficiently load:

  1. Track's plan.md and spec.md
  2. conductor/tech-stack.md -- current stack decisions
  3. conductor/product.md -- product constraints
  4. Recent architectural decision files or ADRs
  5. Existing component/module patterns in codebase
Step 2: Invoke CTO Advisor Frameworks

For each technical aspect of the plan, invoke relevant cto-advisor frameworks:

For architecture decisions:
- Apply ADR template guidance
- Check system design review criteria
- Validate against technology standards

For tech debt concerns:
- Run tech debt analyzer concepts
- Apply debt strategy allocation principles
- Check red flags

For new technologies:
- Apply technology evaluation framework
- Assess vendor management needs
- Calculate cost implications

For quality:
- Check against DORA metrics targets
- Verify testing strategy
- Validate security checklist
Step 3: Generate Technical Review Report
markdown
## CTO Technical Review Report

**Track**: [track-id]
**Reviewer**: cto-plan-reviewer (using cto-advisor frameworks)
**Date**: [YYYY-MM-DD]

### Architecture Assessment

#### Design Decisions
- [x] Architecture pattern: [pattern name] -- appropriate for [reason]
- [ ] CONCERN: [specific issue with decision]
- Recommendation: [specific guidance from ADR framework]

#### System Design
- [x] Component boundaries clear and well-defined
- [x] Separation of concerns maintained
- [ ] CONCERN: Tight coupling between [module A] and [module B]
- Recommendation: [refactoring suggestion]

### Tech Debt Analysis

#### Debt Introduction: [NONE / LOW / MEDIUM / HIGH]
- Debt items introduced:
  1. [Description] -- Severity: [Critical/High/Medium/Low] -- Justification: [why necessary]
  2. [Description] -- Severity: [level] -- Justification: [reason]

#### Mitigation Plan
- [ ] Debt paydown plan required: [yes/no]
- [ ] Capacity allocated: [percentage] -- Aligns with cto-advisor 40/25/15 strategy: [yes/no]

### Technology Evaluation

#### New Dependencies
| Library/Service | Necessity | Alternatives Considered | Lock-in Risk | Cost Impact |
|----------------|-----------|------------------------|--------------|-------------|
| [name] | [justified] | [yes/no - list] | [low/med/high] | [amount/impact] |

#### Integration Assessment
- API design: [quality assessment]
- Error handling: [adequate/needs improvement]
- Retry logic: [present/missing]
- Cost monitoring: [planned/missing]

### Engineering Excellence

#### Testing Strategy: [STRONG / ADEQUATE / WEAK]
- Coverage targets: [percentage] -- Meets cto-advisor 80% threshold: [yes/no]
- TDD applicability: [high/medium/low] -- Justification: [reason]
- Test types planned: [unit/integration/e2e]

#### Performance Criteria: [DEFINED / VAGUE / MISSING]
- Load requirements: [specified/missing]
- Optimization strategy: [present/absent]

#### Security Review: [PASS / NEEDS ATTENTION]
- OWASP top 10 considered: [yes/no]
- Input validation: [planned/missing]
- Auth patterns: [appropriate/needs review]

#### Observability: [COMPREHENSIVE / BASIC / MISSING]
- Monitoring: [planned/missing]
- Logging: [planned/missing]
- Alerting: [planned/missing]

### Team & Process

#### Execution Feasibility: [HIGH / MEDIUM / LOW]
- Team capability match: [assessment]
- Knowledge distribution: [good/concerning]
- Onboarding impact: [low/medium/high]

#### Documentation Plan: [ADEQUATE / NEEDS EXPANSION]
- Technical docs needed: [list]
- ADR required: [yes/no]
- Onboarding docs: [needed/not needed]

### Red Flags

[List any critical concerns from cto-advisor red flags checklist]:
- Increasing technical debt without paydown plan
- Vendor lock-in without escape hatch
- Security vulnerabilities introduced
- Performance bottlenecks designed in
- Tight coupling reducing maintainability

### DORA Metrics Impact Assessment

| Metric | Current Target | Impact of Plan | Assessment |
|--------|---------------|----------------|------------|
| Deployment Frequency | >1/day | [positive/neutral/negative] | [explanation] |
| Lead Time | <1 day | [positive/neutral/negative] | [explanation] |
| MTTR | <1 hour | [positive/neutral/negative] | [explanation] |
| Change Failure Rate | <15% | [positive/neutral/negative] | [explanation] |

### Recommendations

#### Must Fix (Blocking Issues)
1. [Critical issue] -- [specific action required]
2. [Critical issue] -- [specific action required]

#### Should Consider (Improvements)
1. [Suggestion] -- [benefit]
2. [Suggestion] -- [benefit]

#### Nice to Have (Enhancements)
1. [Enhancement] -- [optional benefit]

### Verdict

**Technical Review**: [PASS / PASS WITH CONDITIONS / FAIL]

**PASS**: Technical approach is sound, no blocking issues
**PASS WITH CONDITIONS**: Approved, but recommendations must be addressed during execution
**FAIL**: Blocking issues must be resolved before execution begins

**Rationale**: [1-2 sentence summary of verdict reasoning]

Handoff Protocol

If PASS or PASS WITH CONDITIONS
  • Technical review complete
  • Append this report to the track's plan.md under "## Technical Review"
  • Continue to other plan evaluation checks (scope, overlap, dependencies)
  • If ALL evaluations pass -> Conductor dispatches loop-executor
If FAIL
  • Return to loop-planner with specific technical fixes required
  • Planner revises plan addressing CTO concerns
  • Re-run technical review after revision
  • Max 2 revision cycles before escalating to user for architectural decision

Integration with Evaluate-Loop

This agent is automatically invoked by conductor-orchestrator during Step 2 (EVALUATE PLAN) when the track's spec.md or plan.md contains technical architecture keywords:

Trigger Keywords:

  • Architecture, system design, integration, API, database, schema, migration, infrastructure, scalability, performance, security, authentication, authorization, deployment, monitoring, logging, vendor, technology selection, framework, library

Invocation:

conductor-orchestrator -> detects technical track -> dispatches cto-plan-reviewer -> receives report -> includes in plan evaluation -> proceeds or blocks

Supporting Skills

This agent uses:

  • cto-advisor -- Core technical leadership frameworks and tools
  • context-loader -- Efficient project context loading
  • plan-critiquer -- Deep strategic critique (when architectural decisions require strategic analysis)

Success Criteria

A successful technical review:

  1. Catches architectural issues before code is written
  2. Prevents tech debt accumulation without justification
  3. Ensures technology choices are well-reasoned
  4. Validates testing and quality strategy
  5. Provides actionable recommendations with specific guidance from CTO advisor frameworks
  6. Enables confident execution by addressing technical concerns upfront

Example Usage

Manual invocation:

bash
# User wants technical review of current plan
claude /cto-advisor

# Agent loads plan.md, applies cto-advisor frameworks, generates technical review report

Automatic invocation:

bash
# User runs conductor implement
/conductor implement

# Conductor detects Step 2 (Evaluate Plan) + technical track -> automatically calls cto-plan-reviewer
# Report generated -> included in plan evaluation -> execution proceeds or blocks

© Ibrahim-3d, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cto-plan-reviewer of Ibrahim-3d/orchestrator-supaconductor.

Open the folder on GitHubat commit 76c9b10

Compare with similar skills

Cto Plan Reviewer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cto Plan Reviewer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cto Plan Reviewer this skillIbrahim-3d/orchestrator-supaconductor381—~2.9kAutomated safety check: PassAGPL-3.0
Vanity Engineering Reviewbencium/bencium-marketplace446—~2.4kAutomated safety check: PassMIT
Tech Debt Auditcode-yeongyu/oh-my-openagent70k—~2.4kAutomated safety check: NotesCustom licence
Codebase Pathfinderthedotmack/claude-mem99k—~1.5kAutomated safety check: PassApache-2.0
Architecture SurveyYeachan-Heo/oh-my-claudecode40k—~1.3kAutomated safety check: PassMIT
Technology Radarmagnus919/hermes-profiles289—~1.3kAutomated safety check: PassMIT

Similar skills

  • Vanity Engineering Review

    bencium/bencium-marketplace

    Reviews codebases, architectures, PRs, and technical plans for vanity engineering — code and systems built for the developer's ego, resume, or intellectual pleasure rather than delivering user or…

    446 GitHub stars~2.4k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Tech Debt Audit

    code-yeongyu/oh-my-openagent

    Audits a codebase for technical debt across nine dimensions and writes TECH_DEBT_AUDIT.md with file-cited findings, severity, effort estimates and priorities.

    70k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Codebase Pathfinder

    thedotmack/claude-mem

    Maps a codebase into feature-grouped Mermaid flowcharts, finds duplicated concerns across features and proposes a unified architecture with handoff prompts for planning.

    99k GitHub stars~1.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Architecture Survey

    Yeachan-Heo/oh-my-claudecode

    Periodic survey that walks a repo's module graph and reports ranked candidates for deepening, without changing any code itself.

    40k GitHub stars~1.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Technology Radar

    magnus919/hermes-profiles

    CTO methodology for technology evaluation, architecture governance, build-vs-buy decisions, engineering metrics, technical debt quantification, and innovation pipeline management.

    289 GitHub stars~1.3k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    81k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from Ibrahim-3d/orchestrator-supaconductor

All 27 skills in this repo
  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    381 GitHub starsUsed in 4 repos~2.4k tokens
    Auto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    381 GitHub starsUsed in 9 repos~2.9k tokens
    Auto-check passed
  • Agent Factory

    Ibrahim-3d/orchestrator-supaconductor

    Creates specialized worker agents dynamically from templates.

    381 GitHub stars~2.9k tokensUpdated 13 days ago
    Auto-check passed
  • Board Of Directors

    Ibrahim-3d/orchestrator-supaconductor

    Simulate a 5-member expert board deliberation for major decisions.

    381 GitHub stars~1.9k tokensUpdated 13 days ago
    Auto-check passed
  • Business Docs Sync

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when completing a track that changes pricing, AI models, product features, or asset pipelines — syncs business context documents across all tiers.

    381 GitHub stars~2.1k tokensUpdated 13 days ago
    Auto-check passed
  • Context Loader

    Ibrahim-3d/orchestrator-supaconductor

    Load project context efficiently for Conductor workflows. An agent skill from Ibrahim-3d/orchestrator-supaconductor.

    381 GitHub stars~830 tokensUpdated 13 days ago
    Auto-check passed

Categories

Questions about Cto Plan Reviewer

What does Cto Plan Reviewer do?

Technical architecture review agent for execution plans. An agent skill from Ibrahim-3d/orchestrator-supaconductor. Cto Plan Reviewer is an agent skill from Ibrahim-3d/orchestrator-supaconductor. Technical architecture review agent for execution plans.

When should I use Cto Plan Reviewer?

Cto Plan Reviewer fits situations like: tasks that involve Software architecture; tasks that involve Technical debt.

How do I install Cto Plan Reviewer in Claude Code?

Run `npx skills add Ibrahim-3d/orchestrator-supaconductor --skill cto-plan-reviewer -a claude-code`. Or copy the skill folder (skills/cto-plan-reviewer in Ibrahim-3d/orchestrator-supaconductor) into .claude/skills/cto-plan-reviewer in your project. Claude Code loads it when a task matches its description.

How do I install Cto Plan Reviewer in Codex?

Run `npx skills add Ibrahim-3d/orchestrator-supaconductor --skill cto-plan-reviewer -a codex`. Or copy the skill folder (skills/cto-plan-reviewer in Ibrahim-3d/orchestrator-supaconductor) into .agents/skills/cto-plan-reviewer in your project. Codex loads it when a task matches its description.

Can I use Cto Plan Reviewer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Ibrahim-3d/orchestrator-supaconductor --skill cto-plan-reviewer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cto-plan-reviewer, .gemini/skills/cto-plan-reviewer, .github/skills/cto-plan-reviewer and .opencode/skills/cto-plan-reviewer in your project.

What does Cto Plan Reviewer need to run?

Going by SKILL.md and its folder, Cto Plan Reviewer needs the command-line tools its instructions call (claude).

Does Cto Plan Reviewer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cto Plan Reviewer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cto Plan Reviewer use?

Cto Plan Reviewer is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cto Plan Reviewer use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cto Plan Reviewer?

Skills that share tags, products or a category with Cto Plan Reviewer: Vanity Engineering Review (bencium/bencium-marketplace, 446 stars), Tech Debt Audit (code-yeongyu/oh-my-openagent, 70k stars), Codebase Pathfinder (thedotmack/claude-mem, 99k stars) and Architecture Survey (Yeachan-Heo/oh-my-claudecode, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cto Plan Reviewer?

Ibrahim-3d (a GitHub user) maintains it in Ibrahim-3d/orchestrator-supaconductor, which has 381 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on September 27, 2026.

Source: Ibrahim-3d/orchestrator-supaconductor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.