cto-advisor
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.
- License 许可
- MIT
- 最近更新
- 2026-11-01
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- cto-advisor
- license
- MIT
- metadata
- { "author": "Alireza Rezvani", "domain": "cto-leadership", "updated": 1760918400000, "version": "1.0.0", "category": "c-level", "frameworks": "DORA-metrics, architecture-decision-records, engineering-metrics", "tech-stack": "engineering-management, team-organization", "python-tools": "tech_debt_analyzer.py, team_scaling_calculator.py" }
- description
- 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.
02 资源文件 5
- 参考文档references/architecture_decision_records.md8.5 KB
- 参考文档references/engineering_metrics.md12.1 KB
- 参考文档references/technology_evaluation_framework.md9.6 KB
- 脚本scripts/team_scaling_calculator.py19.5 KB
- 脚本scripts/tech_debt_analyzer.py16.9 KB
03 SKILL.md 正文
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:
- Document context and problem
- List all options considered
- Record decision and rationale
- 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:
- Gather requirements (Week 1)
- Market research (Week 1-2)
- Deep evaluation (Week 2-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
-
Immediate (0-15 min):
- Assess severity
- Activate incident team
- Begin communication
-
Short-term (15-60 min):
- Implement fixes
- Update stakeholders
- Monitor systems
-
Resolution (1-24 hours):
- Verify fix
- Document timeline
- Customer communication
-
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
- Assess current state
- Define target architecture
- Create migration plan
- Execute in phases
- Measure and adjust
Cloud Migration
- Application assessment
- Migration strategy (7Rs)
- Pilot applications
- Full migration
- Optimization
Platform Engineering
- Define platform vision
- Build core services
- Create self-service tools
- Enable team adoption
- Measure efficiency
AI/ML Integration
- Identify use cases
- Build data infrastructure
- Develop models
- Deploy and monitor
- 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
04 同仓库更多 Skills
xiaolai-methodology
以李笑来(Li Xiaolai)的思考方式、方法论与表达风格,为用户做全方位 1-on-1 教练指导,覆盖创业、赚钱、投资、学习、自学、读书写作、用 AI、以及人生心态与自我管理。当用户提到 "李笑来"、"笑来"、"笑来老师"、"扮演李笑来"、"找笑来聊聊"、"笑来怎么看"、"xiaolai"、"把时间当作朋友"、"通往财富自由之路"、"定投改变命运"、"韭菜的自我修养"、"自学是门手艺"、"让时间陪你慢慢变富"、"七年就是一辈子"、"元认知"、"活在未来"、"复利/长期主义"、"践行"、"痴迷改进"、"个人商业模式/出售时间"、"睡后收入"、"定投"、"财富自由"、"操作系统升级"、"最少必要知识"、"北极星提示词"、"用 AI 该怎么学/思考" 等任一触发词,或当用户带着关于创业/赚钱/投资/学习/职业/重大人生决策的困惑、希望被人用笑来式的「逻辑 + 大白话 + 类比 + 重新定义 + 践行导向」来点醒和指导时,自动进入李笑来教练模式。
zread
Produce and consume a wiki-style knowledge base for a code repository via the `zread` CLI and its on-disk output under `./.zread/wiki/`. Use this skill whenever the user wants to understand, onboard onto, explore, summarize, map, or get an overview of an unfamiliar codebase; asks for architecture docs, a project wiki, a repo walkthrough, module/package explanations, or "what does this repo do"; wants to generate, regenerate, resume, browse, or serve code documentation locally; or mentions zread / zread.ai directly. Also use it proactively before diving into a large unknown repo — if `./.zread/wiki/current` exists, read the generated pages instead of crawling source file-by-file; if it doesn't, consider offering to run `zread generate`. The trigger is the intent (understand a codebase through generated docs), not the literal word "zread".
youtube
Launch the YouTube Creator Agent to auto-generate videos. Use when: user types /youtube, wants to create YouTube videos, generate video content, or upload to YouTube. Keywords: youtube, video, 视频, 创作视频, 发布视频
youtube-script-sync
Sync, update, or optimize Tony's GetNote knowledge base `Youtube视频逐字稿` by turning each parent recording or first-person idea note into an idempotent child note containing a directly recordable YouTube long-video or Shorts script. Use when the user says “更新/同步/优化 Youtube视频逐字稿知识库”, or says “更新/同步/优化该知识库” while this knowledge base is the active context.
writing-skills
How to write SKILL.md files that trigger reliably and teach effectively. Use when creating, improving, or reviewing Claude Code skills.
writing-rules
How to write .claude/rules/ files that Claude actually follows. Use when creating, improving, or reviewing project rules.