tomevault-io Gap Analysis Skill
要件と既存コードベースのギャップを分析し、実装戦略を策定するスキル。 既存プロジェクトへの機能追加、リファクタリング計画策定に使用する。
前提条件
| 条件 | 必須 | 説明 |
|---|---|---|
| docs/requirements/user-stories.md | ○ | 分析対象の要件 |
| 既存ソースコード | ○ | ギャップ分析対象 |
出力ファイル
| ファイル | テンプレート | 説明 |
|---|---|---|
| docs/00_analysis/gap_analysis.md | {baseDir}/references/gap_analysis.md | ギャップ分析結果 |
ワークフロー
1. 要件ドキュメント読み込み
2. 現状調査（Current State Investigation）
- ディレクトリ構造・主要モジュール分析
- 再利用可能なコンポーネント特定
- アーキテクチャパターン・制約把握
- 統合ポイント（データモデル、API、認証）特定
3. 要件実現可能性分析（Requirements Feasibility Analysis）
- 技術要件の抽出（データモデル、API、UI、ビジネスルール）
- ギャップ・制約の特定
- 複雑性シグナルの評価
4. 実装アプローチ検討（Implementation Approach Options）
- Option A: 既存コンポーネント拡張
- Option B: 新規コンポーネント作成
- Option C: ハイブリッドアプローチ
5. 複雑性・リスク評価
6. 推奨事項まとめ
分析フレームワーク
現状調査項目
| 調査項目 | 内容 |
|---|---|
| ドメイン関連資産 | 主要ファイル/モジュール、ディレクトリ構成 |
| 規約 | 命名規則、レイヤリング、依存方向 |
| 統合ポイント | データモデル/スキーマ、APIクライアント、認証機構 |
実装アプローチ評価
Option A: 既存コンポーネント拡張
| 評価項目 | 内容 |
|---|---|
| 対象ファイル | 変更が必要なファイル特定 |
| 互換性 | 既存インターフェースとの整合性 |
| 複雑性 | 認知負荷、単一責任原則の維持 |
Trade-offs:
- 新規ファイル最小限、既存パターン活用
- 既存コンポーネント肥大化リスク
Option B: 新規コンポーネント作成
| 評価項目 | 内容 |
|---|---|
| 作成理由 | 責務分離、既存の複雑性、独立ライフサイクル |
| 統合ポイント | 既存システムとの接続方法 |
| 責務境界 | 新規コンポーネントの所有範囲 |
Trade-offs:
- クリーンな責務分離、テスト容易性
- ファイル増加、インターフェース設計必要
Option C: ハイブリッドアプローチ
| 評価項目 | 内容 |
|---|---|
| 組み合わせ戦略 | 拡張部分と新規部分の分担 |
| フェーズ分け | 段階的実装計画 |
| リスク軽減 | インクリメンタルロールアウト、Feature Flag |
複雑性・リスク評価
工数（Effort）
| レベル | 目安 | 条件 |
|---|---|---|
| S | 1-3日 | 既存パターン、最小依存、単純統合 |
| M | 3-7日 | 新パターン/統合あり、中程度複雑性 |
| L | 1-2週 | 大きな機能、複数統合/ワークフロー |
| XL | 2週以上 | アーキテクチャ変更、未知技術、広範影響 |
リスク（Risk）
| レベル | 条件 |
|---|---|
| High | 未知技術、複雑な統合、アーキテクチャ変更、不明確なパフォーマンス/セキュリティ |
| Medium | ガイダンス付き新パターン、管理可能な統合、既知のパフォーマンス解決策 |
| Low | 確立パターンの拡張、馴染みの技術、明確なスコープ、最小統合 |
ツール
| ツール | 用途 |
|---|---|
| Grep | コードベース内パターン検索 |
| Glob | ファイル構造調査 |
| Read | ファイル内容分析 |
| WebSearch | 外部依存調査（必要時） |
| WebFetch | ドキュメント参照（必要時） |
原則
| 原則 | 説明 |
|---|---|
| 情報提供優先 | 決定ではなく分析とオプションを提供 |
| 複数オプション | 実現可能な複数の選択肢を提示 |
| 明示的なギャップ | 不明点と制約を明確にフラグ |
| コンテキスト考慮 | 既存パターンとアーキテクチャ制限に沿う |
| 透明な見積り | 工数とリスクを簡潔に根拠付け |
エラーハンドリング
| エラー | 対応 |
|---|---|
| 要件不在 | /spec で Contract を作成するよう案内（Contract が要件の代わりになる） |
| ソースコードなし | 対象ディレクトリ確認を促す |
| 複雑な統合が不明確 | "Research Needed" としてフラグ、設計フェーズで詳細調査 |
Converted and distributed by TomeVault — claim your Tome and manage your conversions.