- CLAUDE.md 를 .claude/rules/ 4파일로 분할 (project/stack/principles/workflow) - Plans.md 루트 인덱스 (스프린트 목차 + 참조만) - hooks/ pre/post-tool.sh 스켈레톤 (no-op, Sprint 002에서 구현) - .plans/OVERVIEW.md — 목표/범위/성공기준 8개 - .plans/failure-audit.md — F1~F6 실패 감사 (증거 기반) - .plans/design/ 6개 문서: * state-machine.md (XState v5 FSM 설계) * sprint-contract.md (Zod schema + validator) * skill-enforcement.md (4계층 방어) * handoff.md (상태 전이 기반 자매 통신) * retry-policy.md (backoff + escalation) * qa-template.md (체크리스트 runtime) - .plans/sprints/ 8개 스프린트 명세 (SPRINT-000~007) - .plans/migration/from-hanarang-harness.md (자산 매트릭스 + 단계별 가이드) 총 17개 문서, 약 2146 lines. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.4 KiB
1.4 KiB
워크플로우 / 커밋 룰
플랜 문서가 곧 하네스
사용자 자기야의 하드 룰: 모든 단계를 상세 .MD로 작성. root
Plans.md는 참조만.
Plans.md(루트) — 스프린트 목차 + 각 상세 문서로 링크만.plans/OVERVIEW.md— 프로젝트 전체 목표/범위/성공 기준.plans/failure-audit.md— 기존 하네스의 실패 모드 분석 (F1–F6).plans/design/*.md— 설계 문서 (state-machine, sprint-contract, handoff, retry-policy, qa-template, skill-enforcement).plans/sprints/SPRINT-NNN-*.md— 스프린트 상세 명세.plans/migration/from-hanarang-harness.md— 마이그레이션 가이드
커밋/브랜치 룰
- 브랜치:
main(기본) +feature/sprint-NNN-*(스프린트별) - 커밋 메시지:
type(scope): 한국어 요약(Conventional Commits 변형) - Co-Authored-By 풋터 허용 (AI 공동작업 표기)
- 스프린트 완료 시 PR → 다랑이 QA 통과 후 merge
금지 사항
- ❌
hanarang-harness의 Lobster 워크플로우 파일 복사 (결정성 부족 원인) - ❌
bridge.shcurl 기반 디스코드 브릿지 (재구현:discord.js) - ❌
thinking tier xhigh(무한대기) - ❌ 멘션 기반 자매 간 라우팅 (상태 머신 사용)
- ❌
console.*직접 호출 - ❌
any타입 (Zod 경계 이후) - ❌
build단독으로 DoD 충족 판정