qshanx/docs-governance

解決する問題

AI がコードを書くのを支援すると、コードは再生成が安価になりますが、その背後にある推論——なぜその決定がなされたか、テストが何を証明するか、どの領域がリスクがあるか——は失われます。新しいセッションやエージェントは同じ構造を再発見することになり、README は古くなり、アーキテクチャの根拠は消えてしまいます。docs-governance は、プロジェクトのドキュメントを、確認されたコンテキスト、決定、引き継ぎエビデンスを保持する小さなシステムとして扱い、良い作業がセッションを超えて存続し、再利用可能なプロジェクト能力になるようにします。

仕組み

より多くのドキュメントを書くことを強制する代わりに、プラグインは 4 つのファイルを持つ薄いドキュメントの背骨を設定します。各ファイルには単一の責任があります：永続的なルール（CLAUDE.md）、ナビゲーションと触れてはいけない領域（CLAUDE_MAP.md）、現在の健全性と優先事項（PROJECT_STATUS.md）、および追記専用のプロジェクト履歴（PROJECT_LOG.md）。可能な場合は既存のソースを再利用し、既存の PRD/Spec ファイルを権威あるものとして保持します。システムは、Claude Code、Codex、ChatGPT から呼び出せる一連の焦点を絞ったスキルを通じて機能します。例えば、監査、アーキテクチャドキュメント、日常メンテナンス、エージェント向けの執筆などです。監査はデフォルトで読み取り専用です。セットアップはフックを暗黙的にインストールしたり、Git を初期化したり、コミットやプッシュをしたりしません。システムは Markdown を真実の源として使用し、オプションで再構築可能な SQLite インデックス（gitignore されています）を持ちます。

対象読者

これは、Claude Code、Codex、ChatGPT などのツールを使用して長期的な AI 支援プロジェクトを運営するチームや個人向けです。複数のエージェントやセッションがプロジェクトのルール、決定、検証エビデンスについて一貫した理解を共有する必要がある場合、およびセッション間でコンテキストを失いたくない場合に特に役立ちます。

ハイライト

• デフォルトで読み取り専用の監査：/governance-audit は自動書き換えではなくレポートを生成します。
• 各ファイルに明確な単一責任を持つ薄いドキュメントの背骨。
• 既存の PRD/Spec ファイルと既存のナビゲーションを再利用。拡張はオプションのまま。
• オプションの SQLite インデックスは再構築可能で gitignore されています。Markdown は真実の源のまま。
• アーキテクチャドキュメント、変更影響、契約優先コラボレーション、モジュール回帰のための焦点を絞ったスキルを含む。
• エージェントに優しいように書かれています：段階的開示、完了基準、AI が読むドキュメントのローカル最終チェック。