AGENTS.md

이 파일은 하네스(harness) 리소스 라이브러리에 포함된 샘플 템플릿입니다. 실제 프로젝트에 복사한 뒤 프로젝트 고유의 명령어와 경로로 수정하여 사용하십시오. 에이전트(agent)가 세션을 시작할 때 가장 먼저 읽는 파일로, 안정적인 장기 작업의 토대를 제공합니다.

이 저장소는 장기 코딩 에이전트 작업을 위해 설계되었습니다. 목표는 코드 산출물(output)을 극대화하는 것이 아닙니다. 목표는 다음 세션이 추측 없이 계속할 수 있도록 저장소를 남겨 두는 것입니다.

시작 워크플로우 (Startup Workflow)

코드를 작성하기 전에:

pwd로 작업 디렉터리를 확인합니다.
claude-progress.md를 읽어 최신 검증(verified) 상태와 다음 단계를 확인합니다.
feature_list.json을 읽어 가장 높은 우선순위의 미완성 기능을 선택합니다.
git log --oneline -5로 최근 커밋(commit)을 검토합니다.
./init.sh를 실행합니다.
새 작업을 시작하기 전에 필요한 스모크(smoke) 또는 엔드-투-엔드(end-to-end) 검증을 실행합니다.

기준선(baseline) 검증이 이미 실패 중인 경우, 먼저 이를 수정하십시오. 망가진 시작 상태 위에 새 기능 작업을 쌓지 마십시오.

작업 규칙 (Working Rules)

한 번에 하나의 기능만 작업합니다.
코드가 추가되었다고 기능을 완료로 표시하지 않습니다.
차단(blocker)이 좁은 지원 수정을 강제하지 않는 한, 선택한 기능 범위 내에서 변경 사항을 유지합니다.
구현 중에 검증 규칙을 조용히 변경하지 않습니다.
채팅 요약보다 지속적인 저장소 산출물(durable repo artifacts)을 선호합니다.

필수 산출물 (Required Artifacts)

feature_list.json: 기능 상태의 단일 진실 원천(single source of truth)
claude-progress.md: 세션 로그 및 현재 검증 상태
init.sh: 표준 시작 및 검증 경로
session-handoff.md: 대규모 세션을 위한 선택적 간결 핸드오프(handoff)

완료 정의 (Definition Of Done)

다음 조건이 모두 충족될 때만 기능이 완료됩니다.

목표 동작이 구현됨
필요한 검증이 실제로 실행됨
증거(evidence)가 feature_list.json 또는 claude-progress.md에 기록됨
저장소가 표준 시작 경로에서 재시작 가능한 상태를 유지함

세션 종료 (End Of Session)

세션을 종료하기 전에:

claude-progress.md를 업데이트합니다.
feature_list.json을 업데이트합니다.
미해결된 위험 또는 차단 항목을 기록합니다.
작업이 안전한 상태가 되면 설명적인 메시지로 커밋합니다.
다음 세션이 즉시 ./init.sh를 실행할 수 있도록 저장소를 충분히 클린(clean)한 상태로 남겨 둡니다.