本ファイルは、Zeus の文書構造・正本判定・実装同期状態を一元管理する唯一の入口です。
- 同期方針: 実装を正本として文書を同期
- 対象ブランチ: リポジトリ
HEAD
- CLI 契約は
cmd/*.goのcobra.Command定義を正本とする。 - HTTP API 契約は
internal/dashboard/server.goのmux.HandleFunc定義を正本とする。 - 文書間で記載が衝突した場合は、実装定義を優先する。
- 履歴文書は参照可能だが、現行仕様判断の根拠として使わない。
正本: 現行運用・現行仕様の判断に直接使う文書仕様: 実装完了機能の詳細仕様文書設計: 実装中または将来実装対象の設計文書履歴: 廃止仕様・旧設計・過去ガイドの保全文書
完了: 現行実装と同期済み実装中: 一部実装済み、残タスクあり未実装: 実装が存在しない凍結: 履歴保全のみ。現行判断には不使用
| パス | 文書種別 | 実装状態 | 役割 | 備考 |
|---|---|---|---|---|
docs/README.md |
正本 | 完了 | 文書入口/判定ルール | 本ファイル |
docs/operations-manual.md |
正本 | 完了 | 運用手順 | 現行運用判断に使用 |
docs/system-design.md |
正本 | 完了 | システム設計 | 現行アーキテクチャ |
docs/api-reference.md |
正本 | 完了 | CLI/API 契約 | 公開インターフェース |
docs/user-guide.md |
正本 | 完了 | 利用手順 | 利用者向け |
docs/specs/unified-graph-two-layer/README.md |
仕様 | 完了 | UnifiedGraph 2層仕様 | 実装完了仕様 |
docs/archive/implementation-guide.md |
履歴 | 凍結 | 旧実装ガイド | 参照のみ |
docs/archive/detailed-design.md |
履歴 | 凍結 | 旧詳細設計 | 参照のみ |
docs/archive/security.md |
履歴 | 凍結 | 旧セキュリティガイド | 参照のみ |
docs/archive/remove-progress-features.md |
履歴 | 凍結 | 進捗機能削除履歴 | 参照のみ |
- 新規公開コマンド/API 追加時は、実装反映確認後に
docs/api-reference.mdと関連正本文書を更新する。 - 設計文書の実装状態が変わった場合、必ず本マトリクスの状態列を更新する。
- 履歴化対象は
docs/archive/に集約し、現行導線から分離する。