Doc Harness: 세션 간 프로젝트 상태 유지를 위한 Claude 코드 스킬

Doc Harness는 AI 에이전트가 장기 실행 작업 세션 동안 프로젝트 상태를 놓치는 문제를 해결하기 위해 설계된 Claude Code 스킬입니다. 이는 프로젝트 폴더 내에 모든 에이전트가 읽을 수 있는 경량 문서 시스템을 생성하여 프로젝트 상태를 이해하고, 설정된 규칙을 따르며, 작업을 원활하게 계속할 수 있도록 합니다.

해결하는 문제

이 도구는 여러 세션에 걸친 프로젝트에서 Claude Code를 사용할 때 발생하는 일반적인 문제를 해결합니다: 에이전트가 최근 작업을 잊어버리는 컨텍스트 재설정, 30개 이상의 파일로 구성된 프로젝트 탐색의 어려움, 설정된 규칙(예: "커밋 전 항상 테스트하기")을 점차 잊어버리는 문제, 그리고 새로운 에이전트에게 프로젝트를 20분 이상 다시 설명해야 하는 필요성입니다.

작동 방식

Doc Harness는 프로젝트 폴더에 다섯 개의 구조화된 파일을 유지합니다. 핵심 파일은 "움직이는 자동차" 구조를 사용하는 CURRENT_STATUS.md입니다:

• 최근 기록 (어디에 있었는지)
• 현재 작업 세부사항 (어디에 있는지)
• 다음 단계 (어디로 갈 것인지)
• 작동 원칙 (운전하는 방법)

작업 단계가 끝나면 세부사항이 영구적으로 보관되고 상태는 다음 단계를 위해 초기화됩니다.

명령어

이 스킬은 두 가지 주요 명령어를 제공합니다:

• /doc-harness init - 프로젝트에 맞춤화된 다섯 개의 문서를 생성합니다
• /doc-harness check - 문서 상태를 감사합니다 (파일이 등록되었는지와 상태가 최신인지 확인) 그리고 프로젝트 규칙을 에이전트에게 다시 읽어주며, 규칙이 준수되고 있는지에 대한 성찰을 촉구합니다

핵심 원칙

이 도구는 "적어두거나 잃어버리거나"라는 원칙에 따라 작동합니다 - AI 컨텍스트는 일시적이지만 파일은 영구적이라는 점을 인식합니다. 모든 중요한 결과, 결정 또는 통찰력은 파일에 저장되고 인덱스에 등록되어야 합니다.

설치

git clone https://github.com/cilidinezy-commits/doc-harness.git
cp -r doc-harness/skill ~/.claude/skills/doc-harness

설치 후, 슬래시 명령어 대신 자연어를 선호한다면 에이전트에게 "프로젝트 문서 설정"이라고 말할 수 있습니다.

호환성

연구 논문, SaaS 기능, 데이터 분석, 기사, 소프트웨어 라이브러리 및 여러 세션에 걸친 모든 프로젝트 유형에 작동합니다. 영어 및 중국어 버전이 포함되어 있으며, 이 도구는 MIT 라이선스로 배포됩니다.