hoangnb24/repository-harness

해결하는 문제

코드 에이전트는 명확한 의도 부족, 권위 있는 문서 누락, 모호함에 직면했을 때 제품 정책을 추측하여 만들려는 경향이 있어 어려움을 겪습니다. repository-harness는 이 문제를 해결하기 위해 소프트웨어 리포지토리를 증거 기반 변경과 명시적 의사결정 경계를 강조하는 구조화된 에이전트 대응 워크스페이스로 변환합니다.

작동 방식

이 도구는 타겟 프로젝트에 리포지토리 프로토콜과 안전한 업데이터를 설치합니다. AGENTS.md의 컴팩트한 진입점, 문서 맵, 제품 결정 및 실행 계획을 위한 구조를 포함한 핵심 파일 세트를 설정하여 에이전트를 안내합니다. 요청에 대해 특정 워크플로우를 정의합니다: 읽기 전용 요청은 증거를 기반으로 답변하고, 제한된 변경은 증명과 함께 구현되며, 복잡한 변경은 docs/plans/active/에 지속 가능한 계획이 필요합니다.

대상 사용자

AI 코드 에이전트를 사용하고 있으며, 에이전트가 리포지토리의 권위 있는 문서를 따르고, 추측적인 정책을 만들지 않으며, 결정과 진행 상황의 지속 가능한 기록을 유지하기를 원하는 개발자.

주요 특징

• 에이전트 대응 구조: 에이전트가 리포지토리를 이해할 수 있도록 컴팩트한 진입점과 탐색 가능한 맵을 제공.
• 안전한 유지보수: 버전 관리된 바이너리 업데이터를 포함하며, 3-way 머지로 로컬 편집을 보존하고 충돌을 트랜잭션적으로 처리.
• 명시적 의사결정 경계: 모호성이 존재할 경우 중요한 제품 변경 전에 에이전트가 멈추도록 강제.
• 불변성 강제: 불변성을 인코딩하는 선택적 기술과 브라운필드 리포지토리의 명시적 온보딩을 지원.