engineering-constitution

Eric's Engineering Constitutionは、人間とAIエージェントがソフトウェアプロジェクトで協働する方法の単一の真実源として機能する再利用可能なフレームワークです。任意のGitリポジトリに読み取り専用の`constitution/`サブモジュールとして取り込めるように設計されており、少数のローカルプロジェクトファイルと組み合わせて、AIコーディングエージェントとCIパイプラインの両方によって適用されます。 このリポジトリには、権威あるガバナンス文書（CONSTITUTION.md、AI_WORKFLOW.md、INTEGRATION.md、TESTING.md、DOCUMENTATION.md、SECURITY.md、OPERATIONS.md、ARCHITECTURE.md、RELEASES.md、TODO_GUIDELINES.md、KNOWLEDGE_SOURCES.md）、憲法規則を自律的に適用する25の組み込みエージェントスキル、およびCIでコンプライアンスを検証する包括的な参照チェッカースクリプトセットが含まれています。これらのチェッカーは、ベンダーファイル（AGENTS.md、CLAUDE.md、.cursorrulesなど）間の指示テンプレートの一貫性、スキルメタデータの妥当性、要件からテストへのトレーサビリティ、OTSソフトウェアインベントリの相互チェック、アーキテクチャ依存関係ルール（依存関係ルールに従ってソースコードの依存関係が内側を向いていることを保証）、バージョンとリリースタグの整合性、ドキュメントとWikiの鮮度、Wikiリンクの整合性、シークレットスキャン、指示の重み測定をカバーしています。 ブートストラップスクリプト（`scripts/bootstrap.sh`）は、既存のリポジトリを初期化し、サブモジュールを追加し、不足しているガバナンスファイルを作成し、採用レポートを生成します。`--agents`フラグ（claude、cursor、copilot、goose、openhands、antigravity、continue、aider、generic、all）によるオプトインのエージェント指示ファイルをサポートし、デフォルトはAGENTS.mdです。このスクリプトはデフォルトで既存ファイルを上書きせず、テンプレートのコピーを手動マージ用に`.constitution-bootstrap/templates/`に配置します。また、重複を避けるためにマーカー間で管理される標準化された採用バッジをREADMEに追加します。 このフレームワークには、プルリクエスト完了チェックリスト、CODEOWNERS、CIワークフローゲート（SHAピン留め）、Visual Studio用のGitHub Copilot向けSolonカスタムエージェント、製品要件、マイルストーンバックログ、セッションプラン、OTSソフトウェアインベントリ、Wikiホームページ、インシデントポストモーテム用のドキュメントテンプレートが含まれています。また、憲法文書とソースをリソースとして公開するMCPサーバーと、書籍や記事を`ソース/`配下のエージェントが消費可能な要約に蒸留するための知識ソースワークフローも提供します。 IDE統合は自動です。ブートストラップされたリポジトリをVisual Studio、VS Code、またはJetBrains IDEで開くと、AIアシスタント（GitHub Copilot、Continue.dev、Cursor）がコミットされた指示ファイルを読み取ることができ、それらは憲法サブモジュールを指します。Claude CodeのSessionStartフックは、古いサブモジュールを即座にフラグ付けします。フレームワーク自身のCIは、すべてのプルリクエストとmainへのプッシュで完全なテストスイートと自己ガバナンスチェッカーを実行し、リリースタグ整合性ワークフローがバージョンタグを保護します。 このプロジェクトには、統合、バージョン管理（現在1.48.0）、および実践的なサンプルプロジェクトレイアウトに関する広範なドキュメントが含まれています。これはコードライブラリではなくガバナンスレイヤーとして位置付けられており、規律ある測定可能なAI支援開発プラクティスを強調しています。