# 워크플로우 / 커밋 룰

## 플랜 문서가 곧 하네스

> 사용자 자기야의 하드 룰: **모든 단계를 상세 .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 충족 판정