- 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>
30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# 워크플로우 / 커밋 룰
|
||
|
||
## 플랜 문서가 곧 하네스
|
||
|
||
> 사용자 자기야의 하드 룰: **모든 단계를 상세 .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.sh` curl 기반 디스코드 브릿지 (재구현: `discord.js`)
|
||
- ❌ `thinking tier xhigh` (무한대기)
|
||
- ❌ 멘션 기반 자매 간 라우팅 (상태 머신 사용)
|
||
- ❌ `console.*` 직접 호출
|
||
- ❌ `any` 타입 (Zod 경계 이후)
|
||
- ❌ `build` 단독으로 DoD 충족 판정
|