Chachamaru127/claude-code-harness

해결하는 문제

Claude Code Harness는 AI 코딩 에이전트(Claude Code, Cursor, Grok 등)를 위한 체계적인 데리버리 루프를 제공하여 '에이전트 드리프트'를 방지합니다. 이는 계획이 채팅 기록에 사라지고, 압박 속에서 테스트나 리뷰가 생략되는 상황을 막기 위함입니다. 개방형 요청 대신 반복 가능한 구조화된 프로세스를 도입합니다: 사양 작성, 승인된 작업 조각 구현, 검증, 독립적인 리뷰.

작동 방식

이 프로젝트는 다섯 가지 핵심 '동사' 기술(plan, work, review, sync, release)을 통해 구조화된 워크플로우를 구현합니다.

• 계획: 의도를 spec.md와 Plans.md로 변환하여 사용자 승인을 받습니다.
• 구현: 승인된 작업을 실행하며, 필요 시 TDD(Test-Driven Development)를 강제합니다.
• 리뷰: 구현 단계와 독립적으로 결과를 별도로 리뷰합니다.
• 동기화: 실제 구현을 원래 계획과 비교하여 드리프트를 보고합니다.
• 릴리스: 검증된 증거를 변경 로그와 릴리스 태그로 패키지화합니다.

안전성을 보장하기 위해 Go 기반 엔진이 모든 도구 호출을 실행 전에 심사합니다. 이에는 '런타임 플로어'가 포함되어 있으며, 시크릿 읽기나 프로덕션 배포와 같은 고위험 작업을 거부하고, main 브랜치에 직접 푸시하는 등의 작업에 대해 구성 가능한 '가드레일'을 제공합니다.

대상 사용자

AI 코딩 에이전트를 사용하면서 '에이전트에게 코드를 작성하게 하는 것'에서부터 엄격한 경계와 검증 게이트를 갖춘 전문적인 소프트웨어 데리버리 파이프라인으로 전환하고자 하는 개발자들.

주요 특징

• 실행 전 안전성: 실행 후 검토하는 것이 아니라, 위험한 작업이 발생하기 전에 차단하거나 경고하는 Go 기반 엔진.
• 세션 간 통신: 하나의 리포지토리에서 여러 에이전트 세션 간에 통신하고 보고서를 공유할 수 있는 로스터 및 메시징 시스템.
• 비엔지니어용 뷰: Plan Brief, 진행 상황, 승인을 위한 HTML 표면을 제공하여 비기술적 스폰서가 코드를 읽지 않고도 진행 상황을 판단할 수 있도록 합니다.
• 다중 도구 지원: Claude Code, Codex CLI, Cursor, Grok과의 통합 지원.