llm-wiki/.agents/workflows/depth.md

description

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 기록 안 함.