me2resh/apexyard

ApexYard – AI支援によるコードプロジェクトのガバナンス

概要 ApexYardは、Claude Code、opencode、pi、CodexなどのAIコーディングエージェントによって構築（または大幅に支援）されるソフトウェアプロジェクトのポートフォリオを管理するために、チームがフォークして使用できる運用リポジトリです。サービスを実行するわけではなく、AIエージェントが読み取って実行するプレーンテキストのMarkdownファイル、Bashフック、スラッシュコマンドの「スキル」のコレクションにすぎません。

なぜ重要か AIは高速で動作するコードを生成できますが、そのコードを安全に本番環境に移行するには、従来のソフトウェア開発の安全策（チケット、レビュー、品質ゲート、移行計画など）が依然として必要です。ApexYardは、これらの安全策を再利用可能なツールに依存しない方法で体系化するため、Claude Code、opencode、pi、Codex、さらにはCursor IDEを使用する場合でも、同じガバナンスルールが適用されます。

主要コンポーネント

• ロール（約20） – ペルソナ（例：レビューアのRex、セキュリティガードのHakim）をモデル化し、特定のトリガーでアクティブになるMarkdownファイル。
• シェルフック（約60） – git/ghコマンドで実行されるBashスクリプト。「チケットファースト」編集、2マーカーマージゲート、シークレットスキャン、移行チェックなどを強制します。
• スラッシュコマンドスキル（約68） – /setup、/handover、/decide、/code-review、/migration、/launch-checkなどのコマンド。AIエージェントがIDEから直接呼び出せます。
• サブエージェント – 専門的なレビューやチェックを実行する小さなエージェント（Rex、Hakim、Tariqなど）。
• 設定ファイル – onboarding.yaml（gitで無視される）にはプロジェクト固有の設定が含まれ、apexyard.projects.yamlは管理下のリポジトリのリストを追跡します。

一般的なワークフロー

1. ApexYardリポジトリをフォークしてクローンします。
2. /setup（またはonboarding.example.yamlのコピー）を実行して、組織のポリシーを構成します。
3. **/handover <repo>**を使用してコードベースをポートフォリオに追加します。このコマンドはリポジトリをクローンし、「ハーネス可能性」をスコアリングし、apexyard.projects.yamlに記録します。
4. 開発全体を通じて、エージェントは/code-review <pr>や/decideなどのスキルを呼び出して決定を記録し、Bashフックはチケットファーストまたはマージゲートルールに違反するgitアクションをブロックします。
5. PRの準備ができたら、指名された人間（およびオプションでRexエージェント）が、マージゲートが開く前に正確なコミットを明示的に承認する必要があります。
6. 定期的な**/update**により、フォークはアップストリームのApexYardの変更と同期され、Conformance CIジョブは、サポートされているすべてのAIツールが引き続きルールに従うことを再検証します。

ツールサポート

ツール	強制	セットアップ手順
Claude Code	✅ ネイティブ（追加インストール不要）	/setupを実行するだけ
opencode	✅ 実証済み（アダプタースクリプト）	bash bin/install-opencode-adapter.sh
pi	✅ 実証済み	bash bin/install-pi-adapter.sh
Codex	✅ 実証済み	bash bin/sync-codex-adapter.sh
Cursor	✅ IDE内でネイティブ（.claude/をロード）	サードパーティ構成を有効にする+ bash bin/install-cursor-adapter.sh

カスタマイズ すべてのロール、ワークフロー、ドキュメントテンプレートはプレーンテキストのMarkdownファイルであるため、チームはコンパイル済みコードに触れることなく、新しいロールを追加したり、既存のワークフローを編集したり、追加のテンプレートを組み込んだりできます。

はじめに READMEには、6ステップのクイックスタート（フォーク→クローン→アップストリーム追加→/setup→/handover→ポートフォリオコマンドの使用開始）が記載されています。ステータスラインプラグイン（apexyard-status）をClaude Codeプロンプトに追加して、アクティブなチケットと保留中の承認を表示できます。

誰が使うか

• AIエージェントにコードを書かせているが、規律あるSDLCを必要とする企業。
• 多数のマイクロサービスやフロントエンドアプリを管理し、ポリシーの単一の真実のソースを必要とするチーム。
• 複数のAIコーディングアシスタントで動作する「サービスなし」のファイルベースのガバナンス層を好む開発者。

---

上記の詳細はすべてリポジトリのREADMEから直接引用したものであり、追加の機能は推定されていません。