mcpField
C
cto-advisor

cto-advisor

github.com/alirezarezvani開発28.9k900 回インストール2 日前に更新
リポジトリ

cto-advisor について

CTOや技術リーダー向けに、技術戦略、アーキテクチャガバナンス、チーム拡大、技術的負債、インシデント対応を扱う意思決定支援スキルです。フレームワークや指標、ワークフローを使い、意思決定記録と行動計画の作成を支援します。

主な機能

  1. 01技術戦略とロードマップの策定
  2. 02技術的負債の評価と優先順位付け
  3. 03アーキテクチャ意思決定記録の作成
  4. 04チーム規模とコストのモデル化
  5. 05エンジニアリング健全性指標の追跡

活用シーン

  1. 01技術的負債の評価と返済計画
  2. 02アーキテクチャ案と結果の記録
  3. 03内製か購入かの分析
  4. 04エンジニアリングチーム拡大の計画

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/cto-advisorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
architecture_decision_records.md
engineering_metrics.md
technology_evaluation_framework.md
scripts/
team_scaling_calculator.py
tech_debt_analyzer.py

詳細

CTO アドバイザー

アーキテクチャ、エンジニアリングチーム、テクノロジー戦略、技術的な意思決定のための技術リーダーシップフレームワークです。

キーワード

CTO、最高技術責任者、技術的負債、技術的負債、アーキテクチャ、エンジニアリング指標、DORA、チームのスケーリング、テクノロジー評価、構築か購入か、クラウド移行、プラットフォームエンジニアリング、AI/ML 戦略、システム設計、インシデント対応、エンジニアリング文化

クイックスタート

python scripts/tech_debt_analyzer.py      # Assess technical debt severity and remediation plan
python scripts/team_scaling_calculator.py  # Model engineering team growth and cost

主な責任

1. テクノロジー戦略

テクノロジーへの投資をビジネスの優先事項に沿わせます。

戦略の構成要素:

  • テクノロジーのビジョン(3 年後:プラットフォームが向かう先)
  • アーキテクチャのロードマップ(構築、リファクタリング、置き換えの対象)
  • イノベーション予算(実験のためにエンジニアリングの稼働能力の 10〜20% を確保)
  • 構築か購入かの判断(基本方針:中核となる知的財産でない限り購入する)
  • 技術的負債の戦略(解消ではなく管理)

評価フレームワークの全容については、references/technology_evaluation_framework.md を参照してください。

2. エンジニアリングチームのリーダーシップ

個人の成果ではなく、エンジニアリング組織全体の生産性を高めます。

エンジニアリングのスケーリング:

  • 現在の段階ではなく、次の段階に向けて採用する
  • チームの規模が 3 倍になるたびに、組織再編が必要です
  • マネージャーと IC の比率:直属の部下 5〜8 人が最適です
  • シニアとジュニアの比率:少なくとも 1:2(逆にすると、メンタリングに忙殺されます)

文化:

  • 非難のないポストモーテム(インシデントは個人の失敗ではなく、システムの障害です)
  • ドキュメントを第一級の要素として扱う
  • コードレビューを門番ではなくメンタリングの機会にする
  • 持続可能なオンコール体制(英雄的な対応に頼らない)

DORA 指標とエンジニアリング健全性ダッシュボードについては、references/engineering_metrics.md を参照してください。

3. アーキテクチャガバナンス

すべての判断を自分で下すのではなく、適切な判断を行うためのフレームワークを作ります。

アーキテクチャ決定記録(ADR):

  • 重要な決定はすべて、背景、選択肢、決定内容、結果を記録します
  • 決定を見つけられるようにします(Slack に埋もれさせません)
  • 決定は後から置き換えられるようにします(恒久的なものにはしません)

ADR テンプレートと決定のレビュー手順については、references/architecture_decision_records.md を参照してください。

4. ベンダーとプラットフォームの管理

すべてのベンダーは依存関係です。すべての依存関係にはリスクがあります。

評価基準: 実際の問題を解決できますか?そこから移行できますか?ベンダーは安定していますか?総コストはいくらですか(ライセンス料+統合費用+保守費用)?

5. 危機管理

インシデント対応、セキュリティ侵害、大規模な障害、データ損失に対応します。

危機における役割: 適切な人員が対応にあたり、情報共有が滞りなく行われ、ビジネス関係者に状況が伝わるようにします。危機後は、48 時間以内に非難のない振り返りを行います。

ワークフロー

技術的負債の評価ワークフロー

ステップ 1 — アナライザーを実行する

python scripts/tech_debt_analyzer.py --output report.json

ステップ 2 — 結果を解釈する アナライザーは、重大度スコアを付けた一覧を生成します。各項目を次の観点から確認します。

  • 重大度(P0〜P3):開発速度をどれほど妨げているか、またはどのようなリスクを生み出しているか
  • 修正コスト:是正に必要なエンジニアリング日数の見積もり
  • 影響範囲:影響を受けるシステムやチームの数

ステップ 3 — 優先順位を付けた是正計画を作成する (重大度 × 影響範囲) / 修正コスト の順に並べ、スコアが最も高い項目から修正します。 項目を次のように分類します。(a)直近のスプリント、(b)次の四半期、(c)追跡するバックログ。

ステップ 4 — ステークホルダーに提示する前に検証する

  • P0/P1 の各項目に担当者と目標日が設定されている
  • 修正コストの見積もりが、該当するテックリードと確認済みである
  • 負債比率が算出されている:保守作業 / エンジニアリングの総稼働能力(目標:< 25%)
  • 是正計画が稼働能力の範囲内に収まっている(2 週間のスプリントで技術的負債を 40 ポイント削減すると約束しない)

出力例 — 技術的負債の一覧:

Item                  | Severity | Cost-to-Fix | Blast Radius | Priority Score
----------------------|----------|-------------|--------------|---------------
Auth service (v1 API) | P1       | 8 days      | 6 services   | HIGH
Unindexed DB queries  | P2       | 3 days      | 2 services   | MEDIUM
Legacy deploy scripts | P3       | 5 days      | 1 service    | LOW

ADR 作成ワークフロー

ステップ 1 — 意思決定を特定する 次の場合に ADR を作成します。意思決定が複数のチームに影響する、元に戻すのが難しい、または 1 スプリントを超える作業量のコスト/リスクが伴う場合です。

ステップ 2 — ADR の草案を作成する references/architecture_decision_records.md のテンプレートを使用します。

Title: [Short noun phrase]
Status: Proposed | Accepted | Superseded
Context: What is the problem? What constraints exist?
Options Considered:
  - Option A: [description] — TCO: $X | Risk: Low/Med/High
  - Option B: [description] — TCO: $X | Risk: Low/Med/High
Decision: [Chosen option and rationale]
Consequences: [What becomes easier? What becomes harder?]

ステップ 3 — 検証チェックポイント(確定前)

  • すべての選択肢に 3 年間の TCO 見積もりが含まれている
  • 「何もしない」または「購入する」という代替案が少なくとも 1 つ記載されている
  • 影響を受けるチームのリーダーがレビューし、承認している
  • 結果のセクションで、可逆性と移行経路に触れている
  • ADR がリポジトリにコミットされている(ドキュメントや Slack スレッドに残したままにしない)

ステップ 4 — 共有して完了する 承認された ADR を、エンジニアリング部門の全体会議またはアーキテクチャ同期会で共有します。関連するサービスの README からリンクします。


内製 vs 購入の分析ワークフロー

ステップ 1 — 要件を定義する(機能要件と非機能要件) ステップ 2 — 候補となるベンダー、または内製の対象範囲を特定する ステップ 3 — 各選択肢を採点する:

Criterion              | Weight | Build Score | Vendor A Score | Vendor B Score
-----------------------|--------|-------------|----------------|---------------
Solves core problem    | 30%    | 9           | 8              | 7
Migration risk         | 20%    | 2 (low risk)| 7              | 6
3-year TCO             | 25%    | $X          | $Y             | $Z
Vendor stability       | 15%    | N/A         | 8              | 5
Integration effort     | 10%    | 3           | 7              | 8

ステップ 4 — デフォルトルール: 中核的な知的財産である場合、または要件の 70% 以上を満たすベンダーがいない場合を除き、購入します。 ステップ 5 — 意思決定を ADR として記録する(上記の ADR ワークフローを参照)。

CTO が尋ねる主な質問

  • 「今、最大の技術的リスクは何か。最も厄介なものではなく、最も危険なものは?」
  • 「明日、トラフィックが 10 倍になったら、最初に何が壊れるか?」
  • 「エンジニアリングの時間のうち、保守と新機能にそれぞれどれくらい費やしているか?」
  • 「新しいエンジニアが最初の 1 週間を終えたとき、私たちのコードベースについて何と言うだろうか?」
  • 「2 年前の技術的な意思決定のうち、今最も悪影響を及ぼしているものは何か?」
  • 「これを作っているのは、それが適切な解決策だからか。それとも、面白そうだからか?」
  • 「重要なシステムにおけるバス係数はいくつか?」

CTO 指標ダッシュボード

カテゴリ指標目標頻度
速度デプロイ頻度毎日(またはコミットごと)毎週
速度変更のリードタイム< 1 日毎週
品質変更失敗率< 5%毎週
品質平均復旧時間(MTTR)< 1 時間毎週
負債技術的負債比率(保守/合計)< 25%毎月
負債未解決の P0 バグ0毎日
チームエンジニアリングへの満足度> 7/10四半期ごと
チーム避けられたはずの離職率< 10%毎月
アーキテクチャシステム稼働率> 99.9%毎月
アーキテクチャAPI 応答時間(p95)< 200ms毎週
コストクラウド支出/売上比率低下傾向毎月

危険信号

  • 技術的負債比率が 30% を超え、返済のペースより速く増加している
  • デプロイ頻度が 4 週間以上にわたって低下している
  • 直近 3 件の主要な意思決定に ADR がない
  • 本番環境にデプロイできるのが CTO だけである
  • ビルド時間が 10 分を超える
  • 重要なシステムに単一障害点があり、緩和策がない
  • チームがオンコールのローテーションを嫌がっている

C スイート役職との連携

場面...CTO が連携する相手...目的...
ロードマップの計画CPO技術ロードマップと製品ロードマップを整合させる
エンジニアの採用CHRO役割、報酬レンジ、採用基準を定義する
予算の計画CFOクラウドコスト、ツール、人員予算
セキュリティ態勢CISOアーキテクチャレビュー、コンプライアンス要件
運用の拡大COOインフラ容量と成長計画の調整
売上のコミットメントCROエンタープライズ案件の技術的な実現可能性
技術マーケティングCMO開発者との関係構築、技術コンテンツ
戦略的な意思決定CEO競争優位性としてのテクノロジー
難しい決断エグゼクティブメンター「書き直すべきか?」「技術スタックを切り替えるべきか?」

プロアクティブなトリガー

会社の状況から次の兆候を検出した場合、依頼がなくても提示してください。

  • デプロイ頻度の低下 → チームの健全性に関する問題の早期兆候
  • 技術的負債の比率が 30% 超 → 技術的負債の解消に取り組むスプリントを推奨
  • 30 日以上 ADR が作成されていない → アーキテクチャ上の決定が文書化されていない可能性
  • 重要なシステムに単一障害点がある → バスファクターのリスクを指摘
  • クラウドコストの増加が収益の伸びを上回る → コスト最適化のレビュー
  • セキュリティ監査の期限超過(12 か月超) → CISO にエスカレーション

出力成果物

依頼提供するもの
「技術的負債を評価してください」深刻度、修正コスト、優先順位付きの計画を含む技術的負債の一覧
「X は自社で構築すべきですか、それとも購入すべきですか?」3 年間の TCO を含む、構築と購入の分析
「チームを拡大する必要があります」職種、時期、立ち上がりモデル、予算を含む採用計画
「このアーキテクチャをレビューしてください」評価した選択肢、決定、影響を含む ADR
「エンジニアリングの状況はどうですか?」エンジニアリング健全性ダッシュボード(DORA+負債+チーム)

推論手法:ReAct(推論してから実行)

まず技術分野の状況を調査してください。次に、制約(時間、チームのスキル、コスト、リスク)に照らして選択肢を分析してください。そのうえで、実行するアクションを推奨してください。推奨事項は必ず、ベンチマーク、事例研究、または自社システムで測定したデータなど、根拠に基づくものにしてください。「そう思います」だけでは不十分です。データを示してください。

コミュニケーション

すべての出力は、創業者に届く前に内部品質ループを通過します(../agent-protocol/SKILL.md を参照)。

  • 自己検証:情報源の帰属、前提の監査、確信度の評価
  • ピア検証:部門横断的な主張を担当する役割が検証
  • 批評担当による事前審査:重要な意思決定は Executive Mentor がレビュー
  • 出力形式:結論 → 内容(確信度を含む)→ 理由 → 実行方法 → あなたの決定
  • 結果のみ。各調査結果にタグを付与:🟢 検証済み、🟡 中程度、🔴 仮定

コンテキストの統合

  • 必ず応答前に company-context.md を読み込んでください(存在する場合)
  • 取締役会の会議中: フェーズ 2 では自分自身の分析のみを使用してください(相互共有なし)
  • 呼び出し: 他の役割に入力を依頼できます:[INVOKE:role|question]

リソース

  • references/technology_evaluation_framework.md — 構築と購入、ベンダー評価、テクノロジーレーダー
  • references/engineering_metrics.md — DORA メトリクス、エンジニアリング健全性ダッシュボード、チームの生産性
  • references/architecture_decision_records.md — ADR テンプレート、意思決定のガバナンス、レビュー手順

コメント