technical-debt-assessment

技術的負債の評価

目次

• 概要
• 利用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

技術的負債を体系的に特定、測定、管理し、コード品質への投資について十分な情報に基づいて判断できるようにします。

利用する場面

• レガシーコードの評価
• リファクタリングの優先順位付け
• スプリント計画
• コード品質向上の取り組み
• 買収時のデューデリジェンス
• アーキテクチャ上の意思決定

クイックスタート

最小限の動作例：

interface DebtItem {
  id: string;
  title: string;
  description: string;
  category: "code" | "architecture" | "test" | "documentation" | "security";
  severity: "low" | "medium" | "high" | "critical";
  effort: number; // hours
  impact: number; // 1-10 scale
  interest: number; // cost per sprint if not fixed
}

class TechnicalDebtAssessment {
  private items: DebtItem[] = [];

  addDebtItem(item: DebtItem): void {
    this.items.push(item);
  }

  calculatePriority(item: DebtItem): number {
    const severityWeight = {
      low: 1,
      medium: 2,
      high: 3,
      critical: 4,
    };
// ... (see reference guides for full implementation)

リファレンスガイド

詳細な実装については、references/ ディレクトリを参照してください。

ガイド	内容
技術的負債の計算ツール	技術的負債の計算ツール
コード品質スキャナー	コード品質スキャナー

ベストプラクティス

✅ 推奨事項

• 負債の影響を定量化する
• ROI に基づいて優先順位を付ける
• 負債を継続的に追跡する
• スプリントに負債への対応を含める
• 負債に関する判断を文書化する
• 品質ゲートを設定する

❌ 避けるべきこと

• 技術的負債を無視する
• 一度にすべてを修正する
• 影響分析を省略する
• 感情的に判断する