hoangnb24/repository-harness

解決する課題

コーディングエージェントは、明確な制約の欠如、曖昧な権威あるドキュメント、および長期タスク中の進捗の喪失により、失敗することがよくあります。repository-harnessは、ソフトウェアリポジトリを構造化されたエージェント準備完了済みのワークスペースに変換することでこれに対処します。ここでは、リポジトリ自体が外部データベースではなく、信頼できる記録システム（system of record）として機能します。

仕組み

プロジェクト内に標準化されたドキュメントファイルとスクリプトをインストールします。これにより、エージェント向けの小さく安定したエントリポイント（AGENTS.md経由）と、docs/ディレクトリに配置された権威ある知識（アーキテクチャ、ワークフロー、製品の動作など）のマップが作成されます。複雑なタスクに対しては、進捗と決定事項がGitで追跡可能なMarkdownファイルに記録される、永続的な実行プランシステムを実装します。また、リポジトリネイティブなテストを通じた機械的な検証を重視しています。

対象者

AIコーディングエージェントを使用してコードベースを維持・進化させているソフトウェアエンジニアやチームで、重い強制的なワークフローに頼ることなく、エージェントが適切なコンテキストを持ち、アーキテクチャのルールに従うことを確実にしたいと考えている方々。

ハイライト

• エージェント準備完了済みのエントリポイント: コンパクトなAGENTS.mdを使用して、指示の読み込みとドリフトを軽減します。
• 永続的な実行プラン: docs/plans/内で、マルチセッションまたは調整の多い変更を追跡するためのシステムを提供します。
• 真実としてのリポジトリ: すべての製品の動作、決定事項、およびプランをリポジトリ内に保持し、完全な検査可能性を確保します。
• 機械的な検証: 帳簿付けではなく、動作とテストを通じて完了を証明することに焦点を当てています。
• オンボーディングツール: エージェントが既存の（brownfield）リポジトリをマッピングするのを支援する$onboard-repositoryスキルが含まれています。