hoangnb24/repository-harness

해결하는 문제

코딩 에이전트는 명확한 제약 조건의 부족, 모호한 권위 있는 문서, 그리고 장기 작업 중 진행 상황의 손실로 인해 실패하는 경우가 많습니다. repository-harness는 소프트웨어 리포지토리를 구조화된 에이전트 준비 완료 워크스페이스로 변환하여 이 문제를 해결하며, 여기서 리포지토리 자체가 외부 데이터베이스가 아닌 신뢰할 수 있는 기록 시스템(system of record) 역할을 합니다.

작동 방식

프로젝트에 표준화된 문서 파일과 스크립트 세트를 설치합니다. 이를 통해 에이전트를 위한 작고 안정적인 엔트리포인트(AGENTS.md를 통해)와 docs/ 디렉토리에 위치한 권위 있는 지식(아키텍처, 워크플로 및 제품 동작 등)의 맵을 생성합니다. 복잡한 작업의 경우, 진행 상황과 결정 사항이 Git으로 추적되는 Markdown 파일에 기록되는 지속 가능한 실행 계획 시스템을 구현합니다. 또한 리포지토리 네이티브 테스트를 통한 기계적 검증을 강조합니다.

대상

AI 코딩 에이전트를 사용하여 코드베이스를 유지 관리하고 발전시키고 있으며, 무거운 강제 워크플로에 의존하지 않고 에이전트가 적절한 컨텍스트를 갖고 아키텍처 규칙을 따르도록 보장하고자 하는 소프트웨어 엔지니어 및 팀.

주요 특징

• 에이전트 준비 완료 엔트리포인트: 컴팩트한 AGENTS.md를 사용하여 지침 로딩 및 드리프트를 줄입니다.
• 지속 가능한 실행 계획: docs/plans/에서 멀티 세션 또는 조정이 많이 필요한 변경 사항을 추적하기 위한 시스템을 제공합니다.
• 진실로서의 리포지토리: 모든 제품 동작, 결정 및 계획을 리포지토리 내에 유지하여 완전한 검사 가능성을 보장합니다.
• 기계적 검증: 장부 기록이 아닌 동작과 테스트를 통해 완료를 증명하는 데 집중합니다。
• 온보딩 도구: 에이전트가 기존(brownfield) 리포지토리를 매핑하는 데 도움이 되는 $onboard-repository 스킬이 포함되어 있습니다.