46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
---
|
|
description: "새 브랜치 작업 노트를 raw/branch-notes/에 스캐폴딩"
|
|
---
|
|
|
|
사용자가 `/branch <브랜치 이름>` 를 입력하면 아래 절차를 수행한다.
|
|
|
|
브랜치 1개 단위의 작업 노트를 생성합니다.
|
|
|
|
**브랜치 이름:** <브랜치 이름>
|
|
|
|
## 작업 절차
|
|
|
|
1. **인자 검증**
|
|
- 인자가 비어 있으면 사용자에게 브랜치 이름 요청
|
|
- **prefix 4종 (`feature-` / `fix-` / `chore-` / `experiment-`)** + 구현 내용 4~8단어 kebab-case 슬러그
|
|
- 상세는 `rules/naming-conventions.md` §2.1 — 위반은 린터가 생성 시점 차단 (`wiki_structure_lint.py` NAMING_VIOLATION)
|
|
|
|
2. **파일 존재 확인**
|
|
- `raw/branch-notes/<branch-name>.md`가 이미 있으면 **덮어쓰지 말 것**. 기존 경로만 안내하고 종료.
|
|
|
|
3. **스캐폴딩**
|
|
- `templates/branch-note-template.md` 복사 → `raw/branch-notes/<branch-name>.md`
|
|
- 템플릿의 `## Decision Evidence Map` 과 `## Claims To Verify` 섹션을 보존
|
|
- 사용자가 Sources/Claim ID 를 제공했다면 Decision ID 와 Supporting Claims 를 즉시 연결
|
|
- 근거가 아직 없으면 중요한 결정은 `UNSUPPORTED_DECISION` 으로 남기고 추측해서 채우지 않음
|
|
- frontmatter `title`, `branch`, `created`(오늘 날짜) 치환
|
|
- 본문 `# branch: {{branch-name}}` 헤더 치환
|
|
- `status_label`은 `in-progress`로 기본
|
|
|
|
4. **오늘 daily 노트 연결 (있다면)**
|
|
- `raw/daily-notes/YYYY-MM-DD.md` 파일이 존재하면, "활성 브랜치" 섹션에 이 브랜치 항목을 추가
|
|
- daily 파일이 없으면 건드리지 않음 (사용자가 `/daily` 실행할 때 자동 반영하지 않음)
|
|
|
|
5. **사용자 안내**
|
|
- 파일 경로 출력
|
|
- "목표/범위/TODO부터 채워주세요" 안내
|
|
- "`/branch-spec <slug>` 로 채우세요 (끝에 depth+coverage 자동)" 안내
|
|
|
|
## 규칙
|
|
|
|
- **스캐폴딩만**. 내용을 추측해서 채우지 말 것.
|
|
- `Decision Evidence Map` 을 삭제하지 말 것. 비어 있더라도 나중에 Claim ID 를 연결할 구조로 유지.
|
|
- 브랜치 머지/종료 후 `/ingest raw/branch-notes/<branch-name>.md`로 verified 결과를 `wiki/projects/`에 추출.
|
|
- 머지 후에도 branch-note는 raw에 **영구 보관** (삭제 X). 면접/회고 시 결정 사항 근거가 됨.
|
|
- `wiki/log.md`는 기록하지 않음 (브랜치 생성은 빈번, 로그가 노이즈).
|