Ancienttwo/repo-harness
File-backed workflow harness for reliable Claude Code and Codex sessions.
해결하는 문제
repo-harness는 소프트웨어 개발에서 AI 에이전트(Claude 및 Codex 등)를 사용할 때 발생하는 "채팅 메모리 손실"과 토큰 비효율성 문제를 해결합니다. 채팅 스레드의 기록에 의존하는 대신, 프로젝트 상태(계획, 계약, 핸드오프, 증거)를 리포지토리 파일에 직접 배치합니다. 이렇게 하면 새 세션이 시작될 때 에이전트가 전체 코드베이스를 다시 스캔하거나 현재 상태를 다시 도출할 필요 없이 이전 세션이 중단된 지점에서 정확히 재개할 수 있습니다.
작동 방식
이 시스템은 두 계층에서 작동합니다:
- 세션 계약 계층: CLI와 호스트 어댑터(Claude 및 Codex용)를 사용하여 타입이 지정된 훅 런타임을 통해 이벤트를 라우팅합니다. 이러한 훅은 컨텍스트, 계획, 검토 증거를 리포지토리에 기록합니다. 엄격한 수명 주기를 구현합니다: Plan $\rightarrow$ Contract $\rightarrow$ Review. 승인된 계획에서 특정 계약으로 작업이 투영되고, 종료 전에 구조화된 증거로 검증됩니다.
- 봇 예약 프로그램 계층: 장기 실행 작업의 경우 "승인된 프로그램"을 지원합니다. 작업은 갱신 가능한 임대와 엔지니어 바인딩을 통해 관리되어 여러 세션과 다른 에이전트에 걸쳐 작업이 지속될 수 있습니다.
토큰 사용량을 낮게 유지하기 위해 점진적 컨텍스트 로딩(필요한 기능 블록만 로드)을 사용하고, 반복적인 grep-and-read 루프 대신 구조적 쿼리를 위한 CodeGraph 인덱스와 통합합니다.
대상 사용자
복잡한 다중 세션 소프트웨어 엔지니어링 작업, 스프린트, PRD를 관리하기 위해 AI 에이전트(특히 Claude 및 Codex)를 사용하는 개발자와 팀을 위해 설계되었습니다.
주요 기능
- 파일 기반 세션: 채팅 기록이 아닌 리포지토리 아티팩트(핸드오프, 저널)에서 작업을 재개합니다.
- 토큰 효율적 아키텍처: 작은 루트 컨텍스트(약 12KB)와 구조적 CodeGraph 쿼리를 사용하여 토큰 소비를 줄입니다.
- 검토 준비된 증거: 인간 검증을 위한 구조화된 검사 증거와 검토 카드를 생성합니다.
- 타입이 지정된 훅 런타임: 편집 경계에서 관리되는 라우트와 fail-closed 가드를 제공하여 에이전트를 프로젝트 계약에 맞춥니다.
- MCP 플래너 사이드카: ChatGPT가 PRD와 스프린트를 작성하고 Codex가 소스 코드에 대한 직접 쓰기 권한 없이 실행할 수 있도록 합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트