テクニカルマネジメント (TECHNICAL)
エンジニアリング組織の健全性と技術的な資産を「意思決定」と「メトリクス」の両面から管理します。
技術決定記録 (ADR: Architecture Decision Records)
技術選定やアーキテクチャの変更履歴を不変の記録として保存します。
- 運用の流れ:
- 起案 (Proposed): 新しい技術選定を提案。
- 承認 (Accepted): レビューを経て承認・採用。
- 置換/廃棄 (Superseded/Deprecated): 古くなった決定を上書き。
- スター機能: 重要な構成要素(データベース選定など)を「スター」としてマークし、技術スタックのコア情報を強調できます。
- チーム・サービス連携: 特定のチームやマイクロサービスに関連付けて記録を分類可能。
エンジニアリングメトリクス (Four Keys)
DORA (DevOps Research and Assessment) が定義した 4 つの指標を自動収集・可視化します。
- デプロイ頻度 (Deployment Frequency): GitHub 連携などにより、本番環境へのリリース回数を集計。
- 変更のリードタイム (Lead Time for Changes): コミットから本番稼働までの経過時間の平均を算出。
- 変更失敗率 (Change Failure Rate): デプロイ後に発生した障害発生率。
- サービス復旧時間 (Time to Restore Service): 障害検知から解決(クローズ)までの時間を計測。
これらの指標は GitHub Actions のワークフロー完了通知や、Jira などのチケットステータス変化と連携して自動更新されます。
サービスレベル目標 (SLO Management)
システムの信頼性を定量的に定義し、監視します。
- SLI (Service Level Indicator): 計測すべき指標(例: API レイテンシ < 300ms の割合)。
- SLO (Service Level Objective): SLI の達成目標値(例: 99.9%)。
- Error Budget: 目標値に対する余裕分。これを「イノベーション(新機能開発)への投資」に使うか、「信頼性向上」に使うかの判断基準にします。
チームサーベイ (Team Surveys)
開発者体験 (DevEx) やチームの健全性を測るためのアンケート機能です。
- 定期サーベイ: "eNPS" や "DevEx" などの標準テンプレートを利用可能。
- 匿名性: 個人の特定を防ぎ、正直なフィードバックを収集する仕組み。
- 結果の可視化: 時系列での推移を確認し、改善施策の効果を測定します。
カスタムメトリクス (Custom Metrics)
Four Keys 以外の独自の指標を定義し、API 経由でデータをプッシュしてダッシュボード化できます。
- 例: "Code Review Turnaround Time" (コードレビュー完了までの時間)
- 例: "Bug Bounty Reports" (バグ報告数)
システム構成図 (System Topology)
XYFlow (React Flow) を利用し、サービス間の物理的・論理的な依存関係を描画します。
- サービスカタログ: 利用している技術スタック(言語、DB、ライブラリ等)の一覧管理。
- 依存関係の可視化: API の呼び出し元、呼び出し先をグラフ形式で把握し、変更による影響範囲を特定。