hoangnb24/repository-harness

何を解決するか

コードエージェントは、明確な意図の欠如、権威あるドキュメントの不在、曖昧さに直面した際に製品ポリシーを勝手に創出する傾向があるため、しばしば困難に直面します。repository-harness は、証拠に基づく変更と明示的な意思決定の境界を重視する、構造化されたエージェント対応ワークスペースにソフトウェアリポジトリを変換することで、この問題を解決します。

仕組み

このツールは、ターゲットプロジェクトにリポジトリプロトコルと安全なアップデーターをインストールします。AGENTS.md のコンパクトなエントリポイント、ドキュメントマップ、製品意思決定と実行計画の構造といった、コアとなるファイル群を確立し、エージェントを導きます。リクエストには特定のワークフローを定義しています：読み取り専用リクエストには証拠に基づく回答、限定的な変更は証明とともに実装され、複雑な変更には docs/plans/active/ に永続的な計画が必要です。

対象ユーザー

AIコードエージェントを使用しており、エージェントがリポジトリの権威あるドキュメントに従い、推測的なポリシーの創出を避け、意思決定と進捗の永続的な記録を維持することを確保したい開発者。

特徴

• エージェント対応構造: エージェントがリポジトリを理解できるように、コンパクトなエントリポイントとナビゲート可能なマップを提供。
• 安全なメンテナンス: バージョン管理されたバイナリアップデーターを含み、3方向マージを使用してローカル編集を保持し、トランザクション的に衝突を処理。
• 明示的な意思決定境界: 曖昧さがある場合、重要な製品変更を行う前にエージェントが停止するよう強制。
• 不変性の強制: 永続的な不変性をエンコードするオプションのスキルと、ブラウンフィールドリポジトリの明示的オンボーディングをサポート。