39 lines
2.4 KiB
Markdown
39 lines
2.4 KiB
Markdown
---
|
|
description: "브랜치 노트의 구현 착수 깊이 점검 — 1차 구조 린터(wiki_structure_lint.py --file) + 2차 branch-depth-auditor 의미 게이트"
|
|
---
|
|
|
|
사용자가 `/depth <브랜치 이름>` 를 입력하면 아래 절차를 수행한다.
|
|
|
|
브랜치 노트 1개가 **코딩 착수해도 되묻지 않을 만큼 깊은지** 점검합니다.
|
|
(기준: `rules/branch-depth-gate.md` / 결정론 검사: `.claude/hooks/wiki_structure_lint.py`)
|
|
|
|
**브랜치 이름:** <브랜치 이름>
|
|
|
|
## 작업 절차
|
|
|
|
1. **인자 검증** — 비어 있으면 브랜치 이름 요청. `raw/branch-notes/<name>.md` 로 해석(`.md`·`feature-` 누락은 관대히 보정).
|
|
|
|
2. **파일 존재 확인** — 없으면 경로만 안내하고 종료(생성은 `/branch` 의 일).
|
|
|
|
3. **결정론 구조 검사 (1차 — 싸고 빠른 게이트)** — 다음을 실행하고 결과(PASS/FAIL + 사유)를 그대로 보고:
|
|
```
|
|
python3 .claude/hooks/wiki_structure_lint.py --file raw/branch-notes/<name>.md
|
|
```
|
|
- 구조 FAIL(템플릿 누락 섹션 / 백틱 링크 / 깨진 링크 / 빈 선택조건 셀 등)이면 **그것부터** 고치도록 안내. (본 명령은 read-only — 수정은 사용자 또는 `/branch-spec` 의 몫.)
|
|
|
|
4. **의미 깊이 판정 (2차 — R1~R4)** — 1차가 통과(또는 구조 이슈를 사용자가 인지)하면 `branch-depth-auditor` 서브에이전트를 디스패치하고 입력으로 브랜치 노트 경로를 전달.
|
|
- 감사기는 소스를 실제로 읽어 조사 깊이(L0/L1), 결정 조건의 진위, 구현 detail 충분성, 암시된 의존을 *의미*로 판정한다.
|
|
- 감사기 리포트(Verdict + Findings 표 + 다음 행동)를 그대로 출력.
|
|
- **1차가 구조 FAIL 인데도 2차를 돌릴지**: 구조가 심하게 깨졌으면(섹션 다수 누락 등) 먼저 구조부터 고치도록 권하고 2차는 보류. 경미하면 1차 보고 + 2차 동시 진행.
|
|
|
|
5. **종합 판정** — 1차(구조) + 2차(의미) 를 합쳐 `Ready` / `Not ready`. 둘 다 Blocking 0 이어야 Ready.
|
|
|
|
6. **루프** — 사유를 고친 뒤 `/depth <name>` 재실행 → Ready 까지.
|
|
|
|
## 규칙
|
|
|
|
- 검출·판정만(read-only). 1차 린터도 2차 감사기도 노트를 편집하지 않는다.
|
|
- 멱등: 같은 노트에 몇 번 돌려도 안전.
|
|
- 자동 조사·자동 수정 금지 — R1 조사 얕음 갭은 `wiki-decision-researcher` 권고만(사용자 옵트인).
|
|
- `wiki/log.md` 기록 안 함.
|