Cto advisor skill

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

by davila7·MIT license·★ 32,299 Stars on the repo·GitHub ↗

Use now

Files of Cto advisor

davila7/main1 file shown
SKILL.md
Show the full text414 lines

CTO Advisor

Strategic frameworks and tools for technology leadership, team scaling, and engineering excellence.

Keywords

CTO, chief technology officer, technical leadership, tech debt, technical debt, engineering team, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, ADR, architecture decision records, technology strategy, engineering leadership, engineering organization, team structure, hiring plan, technical strategy, vendor evaluation, technology selection

Quick Start

For Technical Debt Assessment
python scripts/tech_debt_analyzer.py

Analyzes system architecture and provides prioritized debt reduction plan.

For Team Scaling Planning
python scripts/team_scaling_calculator.py

Calculates optimal hiring plan and team structure for growth.

For Architecture Decisions

Review references/architecture_decision_records.md for ADR templates and examples.

For Technology Evaluation

Use framework in references/technology_evaluation_framework.md for vendor selection.

For Engineering Metrics

Implement KPIs from references/engineering_metrics.md for team performance tracking.

Core Responsibilities

1. Technology Strategy
Vision & Roadmap
  • Define 3-5 year technology vision
  • Create quarterly roadmaps
  • Align with business strategy
  • Communicate to stakeholders
Innovation Management
  • Allocate 20% time for innovation
  • Run hackathons quarterly
  • Evaluate emerging technologies
  • Build proof of concepts
Technical Debt Strategy
# Assess current debt
python scripts/tech_debt_analyzer.py

# Allocate capacity
- Critical debt: 40% capacity
- High debt: 25% capacity  
- Medium debt: 15% capacity
- Low debt: Ongoing maintenance
2. Team Leadership
Scaling Engineering
# Calculate scaling needs
python scripts/team_scaling_calculator.py

# Key ratios to maintain:
- Manager:Engineer = 1:8
- Senior:Mid:Junior = 3:4:2
- Product:Engineering = 1:10
- QA:Engineering = 1.5:10
Performance Management
  • Set clear OKRs quarterly
  • Conduct 1:1s weekly
  • Review performance quarterly
  • Provide growth opportunities
Culture Building
  • Define engineering values
  • Establish coding standards
  • Create learning programs
  • Foster collaboration
3. Architecture Governance
Decision Making

Use ADR template from references/architecture_decision_records.md:

  1. Document context and problem
  2. List all options considered
  3. Record decision and rationale
  4. Track consequences
Technology Standards
  • Language choices
  • Framework selection
  • Database standards
  • Security requirements
  • API design guidelines
System Design Review
  • Weekly architecture reviews
  • Design documentation standards
  • Prototype requirements
  • Performance criteria
4. Vendor Management
Evaluation Process

Follow framework in references/technology_evaluation_framework.md:

  1. Gather requirements (Week 1)
  2. Market research (Week 1-2)
  3. Deep evaluation (Week 2-4)
  4. Decision and documentation (Week 4)
Vendor Relationships
  • Quarterly business reviews
  • SLA monitoring
  • Cost optimization
  • Strategic partnerships
5. Engineering Excellence
Metrics Implementation

From references/engineering_metrics.md:

DORA Metrics (Deploy to production targets):

  • Deployment Frequency: >1/day
  • Lead Time: <1 day
  • MTTR: <1 hour
  • Change Failure Rate: <15%

Quality Metrics:

  • Test Coverage: >80%
  • Code Review: 100%
  • Technical Debt: <10%

Team Health:

  • Sprint Velocity: ±10% variance
  • Unplanned Work: <20%
  • On-call Incidents: <5/week

Weekly Cadence

Monday
  • Leadership team sync
  • Review metrics dashboard
  • Address escalations
Tuesday
  • Architecture review
  • Technical interviews
  • 1:1s with directs
Wednesday
  • Cross-functional meetings
  • Vendor meetings
  • Strategy work
Thursday
  • Team all-hands (monthly)
  • Sprint reviews (bi-weekly)
  • Technical deep dives
Friday
  • Strategic planning
  • Innovation time
  • Week recap and planning

Quarterly Planning

Q1 Focus: Foundation
  • Annual planning
  • Budget allocation
  • Team goal setting
  • Technology assessment
Q2 Focus: Execution
  • Major initiatives launch
  • Mid-year hiring push
  • Performance reviews
  • Architecture evolution
Q3 Focus: Innovation
  • Hackathon
  • Technology exploration
  • Team development
  • Process optimization
Q4 Focus: Planning
  • Next year strategy
  • Budget planning
  • Promotion cycles
  • Debt reduction sprint

Crisis Management

Incident Response
  1. Immediate (0-15 min):

    • Assess severity
    • Activate incident team
    • Begin communication
  2. Short-term (15-60 min):

    • Implement fixes
    • Update stakeholders
    • Monitor systems
  3. Resolution (1-24 hours):

    • Verify fix
    • Document timeline
    • Customer communication
  4. Post-mortem (48-72 hours):

    • Root cause analysis
    • Action items
    • Process improvements
Types of Crises
Security Breach
  • Isolate affected systems
  • Engage security team
  • Legal/compliance notification
  • Customer communication plan
Major Outage
  • All-hands response
  • Status page updates
  • Executive briefings
  • Customer outreach
Data Loss
  • Stop writes immediately
  • Assess recovery options
  • Begin restoration
  • Impact analysis

Stakeholder Management

Board/Executive Reporting

Monthly:

  • KPI dashboard
  • Risk register
  • Major initiatives status

Quarterly:

  • Technology strategy update
  • Team growth and health
  • Innovation highlights
  • Budget review
Cross-functional Partners
Product Team
  • Weekly roadmap sync
  • Sprint planning participation
  • Technical feasibility reviews
  • Feature estimation
Sales/Marketing
  • Technical sales support
  • Product capability briefings
  • Customer reference calls
  • Competitive analysis
Finance
  • Budget management
  • Cost optimization
  • Vendor negotiations
  • Capex planning

Strategic Initiatives

Digital Transformation
  1. Assess current state
  2. Define target architecture
  3. Create migration plan
  4. Execute in phases
  5. Measure and adjust
Cloud Migration
  1. Application assessment
  2. Migration strategy (7Rs)
  3. Pilot applications
  4. Full migration
  5. Optimization
Platform Engineering
  1. Define platform vision
  2. Build core services
  3. Create self-service tools
  4. Enable team adoption
  5. Measure efficiency
AI/ML Integration
  1. Identify use cases
  2. Build data infrastructure
  3. Develop models
  4. Deploy and monitor
  5. Scale adoption

Communication Templates

Technology Strategy Presentation
1. Executive Summary (1 slide)
2. Current State Assessment (2 slides)
3. Vision & Strategy (2 slides)
4. Roadmap & Milestones (3 slides)
5. Investment Required (1 slide)
6. Risks & Mitigation (1 slide)
7. Success Metrics (1 slide)
Team All-hands
1. Wins & Recognition (5 min)
2. Metrics Review (5 min)
3. Strategic Updates (10 min)
4. Demo/Deep Dive (15 min)
5. Q&A (10 min)
Board Update Email
Subject: Engineering Update - [Month]

Highlights:
• [Major achievement]
• [Key metric improvement]
• [Strategic progress]

Challenges:
• [Issue and mitigation]

Next Month:
• [Priority 1]
• [Priority 2]

Detailed metrics attached.

Tools & Resources

Essential Tools
  • Architecture: Draw.io, Lucidchart, C4 Model
  • Metrics: DataDog, Grafana, LinearB
  • Planning: Jira, Confluence, Notion
  • Communication: Slack, Zoom, Loom
  • Development: GitHub, GitLab, Bitbucket
Key Resources
  • Books:

    • "The Manager's Path" - Camille Fournier
    • "Accelerate" - Nicole Forsgren
    • "Team Topologies" - Skelton & Pais
  • Frameworks:

    • DORA metrics
    • SPACE framework
    • Team Topologies
  • Communities:

    • CTO Craft
    • Engineering Leadership Slack
    • LeadDev community

Success Indicators

✅ Technical Excellence

  • System uptime >99.9%
  • Deploy multiple times daily
  • Technical debt <10% capacity
  • Security incidents = 0

✅ Team Success

  • Team satisfaction >8/10
  • Attrition <10%
  • Filled positions >90%
  • Diversity improving

✅ Business Impact

  • Features on-time >80%
  • Engineering enables revenue
  • Cost per transaction decreasing
  • Innovation driving growth

Red Flags to Watch

⚠️ Increasing technical debt
⚠️ Rising attrition rate
⚠️ Slowing velocity
⚠️ Growing incidents
⚠️ Team morale declining
⚠️ Budget overruns
⚠️ Vendor dependencies
⚠️ Security vulnerabilities

1---
2name: cto-advisor
3description: Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Includes tech debt analyzer, team scaling calculator, engineering metrics frameworks, technology evaluation tools, and ADR templates. Use when assessing technical debt, scaling engineering teams, evaluating technologies, making architecture decisions, establishing engineering metrics, or when user mentions CTO, tech debt, technical debt, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, or technology strategy.
4license: MIT
5metadata:
6 version: 1.0.0
7 author: Alireza Rezvani
8 category: c-level
9 domain: cto-leadership
10 updated: 2025-10-20
11 python-tools: tech_debt_analyzer.py, team_scaling_calculator.py
12 frameworks: DORA-metrics, architecture-decision-records, engineering-metrics
13 tech-stack: engineering-management, team-organization
14---
15 
16# CTO Advisor
17 
18Strategic frameworks and tools for technology leadership, team scaling, and engineering excellence.
19 
20## Keywords
21CTO, chief technology officer, technical leadership, tech debt, technical debt, engineering team, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, ADR, architecture decision records, technology strategy, engineering leadership, engineering organization, team structure, hiring plan, technical strategy, vendor evaluation, technology selection
22 
23## Quick Start
24 
25### For Technical Debt Assessment
26```bash
27python scripts/tech_debt_analyzer.py
28```
29Analyzes system architecture and provides prioritized debt reduction plan.
30 
31### For Team Scaling Planning
32```bash
33python scripts/team_scaling_calculator.py
34```
35Calculates optimal hiring plan and team structure for growth.
36 
37### For Architecture Decisions
38Review `references/architecture_decision_records.md` for ADR templates and examples.
39 
40### For Technology Evaluation
41Use framework in `references/technology_evaluation_framework.md` for vendor selection.
42 
43### For Engineering Metrics
44Implement KPIs from `references/engineering_metrics.md` for team performance tracking.
45 
46## Core Responsibilities
47 
48### 1. Technology Strategy
49 
50#### Vision & Roadmap
51- Define 3-5 year technology vision
52- Create quarterly roadmaps
53- Align with business strategy
54- Communicate to stakeholders
55 
56#### Innovation Management
57- Allocate 20% time for innovation
58- Run hackathons quarterly
59- Evaluate emerging technologies
60- Build proof of concepts
61 
62#### Technical Debt Strategy
63```bash
64# Assess current debt
65python scripts/tech_debt_analyzer.py
66 
67# Allocate capacity
68- Critical debt: 40% capacity
69- High debt: 25% capacity
70- Medium debt: 15% capacity
71- Low debt: Ongoing maintenance
72```
73 
74### 2. Team Leadership
75 
76#### Scaling Engineering
77```bash
78# Calculate scaling needs
79python scripts/team_scaling_calculator.py
80 
81# Key ratios to maintain:
82- Manager:Engineer = 1:8
83- Senior:Mid:Junior = 3:4:2
84- Product:Engineering = 1:10
85- QA:Engineering = 1.5:10
86```
87 
88#### Performance Management
89- Set clear OKRs quarterly
90- Conduct 1:1s weekly
91- Review performance quarterly
92- Provide growth opportunities
93 
94#### Culture Building
95- Define engineering values
96- Establish coding standards
97- Create learning programs
98- Foster collaboration
99 
100### 3. Architecture Governance
101 
102#### Decision Making
103Use ADR template from `references/architecture_decision_records.md`:
1041. Document context and problem
1052. List all options considered
1063. Record decision and rationale
1074. Track consequences
108 
109#### Technology Standards
110- Language choices
111- Framework selection
112- Database standards
113- Security requirements
114- API design guidelines
115 
116#### System Design Review
117- Weekly architecture reviews
118- Design documentation standards
119- Prototype requirements
120- Performance criteria
121 
122### 4. Vendor Management
123 
124#### Evaluation Process
125Follow framework in `references/technology_evaluation_framework.md`:
1261. Gather requirements (Week 1)
1272. Market research (Week 1-2)
1283. Deep evaluation (Week 2-4)
1294. Decision and documentation (Week 4)
130 
131#### Vendor Relationships
132- Quarterly business reviews
133- SLA monitoring
134- Cost optimization
135- Strategic partnerships
136 
137### 5. Engineering Excellence
138 
139#### Metrics Implementation
140From `references/engineering_metrics.md`:
141 
142**DORA Metrics** (Deploy to production targets):
143- Deployment Frequency: >1/day
144- Lead Time: <1 day
145- MTTR: <1 hour
146- Change Failure Rate: <15%
147 
148**Quality Metrics**:
149- Test Coverage: >80%
150- Code Review: 100%
151- Technical Debt: <10%
152 
153**Team Health**:
154- Sprint Velocity: ±10% variance
155- Unplanned Work: <20%
156- On-call Incidents: <5/week
157 
158## Weekly Cadence
159 
160### Monday
161- Leadership team sync
162- Review metrics dashboard
163- Address escalations
164 
165### Tuesday
166- Architecture review
167- Technical interviews
168- 1:1s with directs
169 
170### Wednesday
171- Cross-functional meetings
172- Vendor meetings
173- Strategy work
174 
175### Thursday
176- Team all-hands (monthly)
177- Sprint reviews (bi-weekly)
178- Technical deep dives
179 
180### Friday
181- Strategic planning
182- Innovation time
183- Week recap and planning
184 
185## Quarterly Planning
186 
187### Q1 Focus: Foundation
188- Annual planning
189- Budget allocation
190- Team goal setting
191- Technology assessment
192 
193### Q2 Focus: Execution
194- Major initiatives launch
195- Mid-year hiring push
196- Performance reviews
197- Architecture evolution
198 
199### Q3 Focus: Innovation
200- Hackathon
201- Technology exploration
202- Team development
203- Process optimization
204 
205### Q4 Focus: Planning
206- Next year strategy
207- Budget planning
208- Promotion cycles
209- Debt reduction sprint
210 
211## Crisis Management
212 
213### Incident Response
2141. **Immediate** (0-15 min):
215 - Assess severity
216 - Activate incident team
217 - Begin communication
218 
2192. **Short-term** (15-60 min):
220 - Implement fixes
221 - Update stakeholders
222 - Monitor systems
223 
2243. **Resolution** (1-24 hours):
225 - Verify fix
226 - Document timeline
227 - Customer communication
228 
2294. **Post-mortem** (48-72 hours):
230 - Root cause analysis
231 - Action items
232 - Process improvements
233 
234### Types of Crises
235 
236#### Security Breach
237- Isolate affected systems
238- Engage security team
239- Legal/compliance notification
240- Customer communication plan
241 
242#### Major Outage
243- All-hands response
244- Status page updates
245- Executive briefings
246- Customer outreach
247 
248#### Data Loss
249- Stop writes immediately
250- Assess recovery options
251- Begin restoration
252- Impact analysis
253 
254## Stakeholder Management
255 
256### Board/Executive Reporting
257**Monthly**:
258- KPI dashboard
259- Risk register
260- Major initiatives status
261 
262**Quarterly**:
263- Technology strategy update
264- Team growth and health
265- Innovation highlights
266- Budget review
267 
268### Cross-functional Partners
269 
270#### Product Team
271- Weekly roadmap sync
272- Sprint planning participation
273- Technical feasibility reviews
274- Feature estimation
275 
276#### Sales/Marketing
277- Technical sales support
278- Product capability briefings
279- Customer reference calls
280- Competitive analysis
281 
282#### Finance
283- Budget management
284- Cost optimization
285- Vendor negotiations
286- Capex planning
287 
288## Strategic Initiatives
289 
290### Digital Transformation
2911. Assess current state
2922. Define target architecture
2933. Create migration plan
2944. Execute in phases
2955. Measure and adjust
296 
297### Cloud Migration
2981. Application assessment
2992. Migration strategy (7Rs)
3003. Pilot applications
3014. Full migration
3025. Optimization
303 
304### Platform Engineering
3051. Define platform vision
3062. Build core services
3073. Create self-service tools
3084. Enable team adoption
3095. Measure efficiency
310 
311### AI/ML Integration
3121. Identify use cases
3132. Build data infrastructure
3143. Develop models
3154. Deploy and monitor
3165. Scale adoption
317 
318## Communication Templates
319 
320### Technology Strategy Presentation
321```
3221. Executive Summary (1 slide)
3232. Current State Assessment (2 slides)
3243. Vision & Strategy (2 slides)
3254. Roadmap & Milestones (3 slides)
3265. Investment Required (1 slide)
3276. Risks & Mitigation (1 slide)
3287. Success Metrics (1 slide)
329```
330 
331### Team All-hands
332```
3331. Wins & Recognition (5 min)
3342. Metrics Review (5 min)
3353. Strategic Updates (10 min)
3364. Demo/Deep Dive (15 min)
3375. Q&A (10 min)
338```
339 
340### Board Update Email
341```
342Subject: Engineering Update - [Month]
343 
344Highlights:
345• [Major achievement]
346• [Key metric improvement]
347• [Strategic progress]
348 
349Challenges:
350• [Issue and mitigation]
351 
352Next Month:
353• [Priority 1]
354• [Priority 2]
355 
356Detailed metrics attached.
357```
358 
359## Tools & Resources
360 
361### Essential Tools
362- **Architecture**: Draw.io, Lucidchart, C4 Model
363- **Metrics**: DataDog, Grafana, LinearB
364- **Planning**: Jira, Confluence, Notion
365- **Communication**: Slack, Zoom, Loom
366- **Development**: GitHub, GitLab, Bitbucket
367 
368### Key Resources
369- **Books**:
370 - "The Manager's Path" - Camille Fournier
371 - "Accelerate" - Nicole Forsgren
372 - "Team Topologies" - Skelton & Pais
373 
374- **Frameworks**:
375 - DORA metrics
376 - SPACE framework
377 - Team Topologies
378 
379- **Communities**:
380 - CTO Craft
381 - Engineering Leadership Slack
382 - LeadDev community
383 
384## Success Indicators
385 
386✅ **Technical Excellence**
387- System uptime >99.9%
388- Deploy multiple times daily
389- Technical debt <10% capacity
390- Security incidents = 0
391 
392✅ **Team Success**
393- Team satisfaction >8/10
394- Attrition <10%
395- Filled positions >90%
396- Diversity improving
397 
398✅ **Business Impact**
399- Features on-time >80%
400- Engineering enables revenue
401- Cost per transaction decreasing
402- Innovation driving growth
403 
404## Red Flags to Watch
405 
406⚠️ Increasing technical debt
407⚠️ Rising attrition rate
408⚠️ Slowing velocity
409⚠️ Growing incidents
410⚠️ Team morale declining
411⚠️ Budget overruns
412⚠️ Vendor dependencies
413⚠️ Security vulnerabilities
414 

Discussion

Alternatives