.github/copilot ディレクトリを「Copilot エージェントの単一仕様源（SSOT）」として体系設計する

[LevelCapTech]

このプルリクエストは、リポジトリ内のCopilotおよび自動エージェントのための包括的で階層化されたドキュメントと運用標準を導入します。すべての仕様に対する「唯一の真実の情報源」（SSOT）を確立し、厳格な2層構造（規範層と仕様層）を導入し、設計と実装のための詳細なテンプレートとチェックリストを提供し、テスト、セキュリティ、CI品質ゲート、コミット規約に関する要件を形式化します。これらの変更は、再現性、セキュリティ、そして高品質な開発ワークフローを実現し、将来の拡張性とマルチリポジトリシナリオをサポートするように構成されています。

主な変更点：

1. コア仕様構造とインデックス

• すべてのCopilot/エージェント関連仕様の公式エントリポイントおよびSSOTとして.github/copilot/00-index.mdを導入しました。これにより、すべてのドキュメント層における厳格な参照順序が定義され、規範ルールと補足資料の区別が明確になります。
• リポジトリ構成モード（モノレポ、ポリレポ、レンタルサーバー）を定義するための .github/copilot/05-structure/README.md および関連構造ファイルを追加しました。ドキュメントと CI 間での切り替えと一貫性の維持に関する明確なガイダンスが含まれています。[1] [2] [3]

2. 規範レイヤーと仕様レイヤー

• .github/copilot-instructions.md を刷新し、簡潔で強力な規範レイヤーとして機能させました。これにより、日本語の PR タイトル、コミットメッセージ構造、コード/ドキュメントの完全な提出、そして計画検証を伴う設計→実装ループの厳格な遵守が義務付けられました。
• 階層化されたドキュメントを追加しました: 要件 (10-requirements.md)、アーキテクチャ (20-architecture.md)、コーディング標準 (30-coding-standards.md)、テスト戦略 (40-testing-strategy.md)、セキュリティ ポリシー (50-security.md)、CI 品質ゲート (60-ci-quality-gates.md)、ADR テンプレート (70-adr/ADR-template.md)、および研究ハンドオフ (90-research/design-implement-plan-handoff.md)。 [1] [2] [3] [4] [5] [6] [7] [8]

3. テンプレートと運用チェックリスト

• .github/copilot/80-templates/ に実装計画と PR/コードレビューチェックリストのテンプレートを追加しました。これにより、すべての変更が明確な承認およびロールバック基準に基づいて計画、テスト、文書化、レビューされるようになります。 [1] [2] [3]

4.コミットメッセージと指示ルール

• .github/instructions/commit-messages.instructions.md を導入し、Copilot 生成および人力によるコミットすべてにおいて、日本語で構造化されたプレフィックス付きのコミットメッセージを、最低3行の形式で使用することを強制しました。
• .github/instructions/Readme.md を追加し、指示ファイルの使用方法と命名規則を明確化しました。

5. 調査と計画の強化

• API 統合 (freee API) に関する詳細な調査および計画ドキュメントを追加しました。これには、技術調査、実装計画、認証、レート制限、シークレットの安全な取り扱いに関する運用上の推奨事項が含まれています。 [1] [2]

これらの変更により、Copilotと自動エージェントを用いた、仕様主導型で再現性が高く安全な開発のための堅牢なフレームワークが確立されます。