日本語 —
docs-analysisの公式日本語版。
ドキュメント要件分析 (日本語)
すべてのコンセプトおよび要件ドキュメントを分析し、現在のコードと照らし合わせて要件を検証し、統合差異レポートを作成します。
概要と目的
../docs/ フォルダ内のすべてのコンセプトおよび要件ドキュメントを分析し、現在のコードと照らし合わせて要件を検証し、統合差異レポートを作成します。
命名規則
プレフィックスとサフィックス
分析されたすべてのドキュメントには以下が付与されます:
- プレフィックス:
conN_(N = 分析バージョン: 1, 2, 3, ...) - サフィックス:
_XX(XX = 達成率: 10 単位に四捨五入)
アーカイブのしきい値
- >= 75% 達成: ドキュメントは
../docs/_archive/に移動されます - < 75% 達成: ドキュメントはプレフィックス/サフィックス付きで
../docs/に残ります - しきい値は設定可能 (デフォルト: 75)
プロセス
フェーズ 1: ドキュメントの収集
- ../docs/ (ルート) 内のすべての *.md および *.txt ファイルを一覧表示
- README.txt を除外
フェーズ 2: 要件の抽出
各ドキュメントについて:
- コンテンツの読み込み
- 要件の特定(チェックリスト、テーブル、MISSING/TODO マーカー)
- 分類: Structure、Code、API、DB Schema、CLI、Feature
フェーズ 3: コードの検証
各要件について:
- 検証方法の決定(Glob、Grep、Read)
- 検証の実行
- ステータスの設定: FULFILLED、PARTIAL、MISSING
フェーズ 4: 評価
- 達成された要件と未達成の要件をカウント
- 達成率 (%) を計算
- 判定: アーカイブ (>= 75%) または保持 (< 75%)
フェーズ 5: 出力の生成
- REQUIREMENTS_ANALYSIS.md を作成(サマリー)
- consense_diff.md を作成(未達成要件のみ、優先度順)
フェーズ 6: バージョニング
- 最高の conN_ プレフィックスをスキャン
- 新しいバージョン = 最高バージョン + 1
フェーズ 7: リネームと移動
- ドキュメントに新しいプレフィックス/サフィックスを適用
- アーカイブまたは保持
出力
| ファイル | 説明 |
|---|---|
conN_REQUIREMENTS_ANALYSIS.md |
完全な分析 (バージョン N) |
consense_diff_N.md |
統合された未達成要件 |
_archive/conN_*_XX.* |
アーカイブ済み (>=75%) のドキュメント |
優先度分類
| 優先度 | 基準 |
|---|---|
| P1 | 主要機能の欠落、システム使用不可 |
| P2 | 重要な機能の欠落、回避策あり |
| P3 | あれば良い機能、UX を向上 |
| P4 | 軽微な改善、ドキュメント、コード品質 |
変更履歴
1.0.0 (2026-03-15)
- BACH v3.8.0 から移植
BACH v3.8.0 から移植 | スタンドアロン版