mcpField
C
cto-advisor

cto-advisor

github.com/shipshitdevDevelopment39179 installsUpdated 5d ago
Repository

About cto-advisor

A skill for people responsible for technical and engineering leadership, covering technology strategy, team growth, architecture decisions, vendor evaluation, and engineering metrics. It includes assessment and planning scripts plus reference material.

Key features

  1. 01Develop technology strategy and roadmaps
  2. 02Plan team scaling and hiring
  3. 03Support architecture decisions and ADRs
  4. 04Evaluate technologies and vendors
  5. 05Consult engineering and DORA metrics

Use cases

  1. 01Set the engineering budget share for paying down tech debt
  2. 02Plan team size and hiring
  3. 03Document architecture decisions and assess technology choices

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipshitdev/skills --skill cto-advisor

After installing, type/cto-advisorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

plugin.json
references/
architecture_decision_records.md
engineering_metrics.md
full-guide.md
technology_evaluation_framework.md
scripts/
team_scaling_calculator.py
tech_debt_analyzer.py

Details

From the project README

CTO Advisor

When This Activates

  • User mentions CTO, technical leadership, or engineering leadership
  • User asks how much of the engineering budget to spend paying debt down — the portfolio-level call, not the codebase inventory (tech-debt owns that)
  • User needs team scaling or hiring plans
  • User wants architecture decisions or ADRs
  • User asks about engineering metrics or DORA metrics
  • User needs technology evaluation or vendor selection

Quick Start

Tech Debt Assessment
python scripts/tech_debt_analyzer.py
Team Scaling Planning
python scripts/team_scaling_calculator.py
Architecture Decisions

See references/architecture_decision_records.md

Technology Evaluation

See references/technology_evaluation_framework.md

Engineering Metrics

See references/engineering_metrics.md

Core Responsibilities

AreaFocus
Technology StrategyVision, roadmaps, innovation, tech debt
Team LeadershipScaling, performance, culture
Architecture GovernanceDecisions, standards, reviews
Vendor ManagementEvaluation, relationships, SLAs
Engineering ExcellenceMetrics, quality, reliability

Key Ratios

MetricTarget
Manager:Engineer1:8
Senior:Mid:Junior3:4:2
Product:Engineering1:10
QA:Engineering1.5:10

DORA Metrics Targets

MetricEliteHigh
Deployment FrequencyOn-demand1/day - 1/week
Lead Time<1 hour1 day - 1 week
MTTR<1 hour<1 day
Change Failure Rate<15%<30%

Success Indicators

AreaTarget
System uptime>99.9%
Tech debt capacity<10%
Team satisfaction>8/10
Attrition rate<10%
Features on-time>80%

Red Flags

  • Increasing technical debt
  • Rising attrition rate
  • Slowing velocity
  • Growing incidents
  • Team morale declining
  • Budget overruns

Integration

SkillWhen to Use
performance-expertOptimize system performance
security-expertSecurity architecture
testing-expertTesting strategy

Related

  • tech-debt — scan a real codebase and rank its debt into a register; this skill sets the investment level, that one finds the items.

For detailed operational guidance, cadences, crisis management, and templates: references/full-guide.md

Comments

Markdown supported