33 lines
2.3 KiB
Markdown
33 lines
2.3 KiB
Markdown
프로젝트 1개의 최상위 hub 노트를 생성합니다. (채움은 `/project-spec`, 생성은 본 명령.)
|
|
|
|
**프로젝트 slug:** {{arguments}}
|
|
|
|
## 작업 절차
|
|
|
|
1. **인자 검증** (`rules/naming-conventions.md` 준수)
|
|
- 인자가 비어 있으면 사용자에게 프로젝트 slug 요청.
|
|
- kebab-case 권장 (`ca-skeleton-operational-contract`, `keycloak-patterns-overview`).
|
|
- branch prefix 4종 규칙은 **비적용** (그건 branch 전용). slug 는 프로젝트 이름.
|
|
|
|
2. **파일 존재 확인**
|
|
- `raw/project-notes/<slug>.md` 가 이미 있으면 **덮어쓰지 말 것**. 기존 경로만 안내하고 종료.
|
|
|
|
3. **스캐폴딩**
|
|
- `wiki-doc-author`(mode=create, category=project-note)에 위임이 **기본**(upward-link/tag 정규화 수행). 그게 불가할 때만 `templates/project-template.md` 직접 복사 → `raw/project-notes/<slug>.md`.
|
|
- frontmatter `title`(slug 를 사람이 읽는 형태로), `status: draft`, `status_label: active`, `last_reviewed`(오늘) 치환.
|
|
- **v2 필수**: `project_revision: 1` 을 유지하고 `## 6.1 Project Decision Registry`, `## 8.0 Work Item Registry` skeleton 을 삭제하지 않는다.
|
|
- 본문 `# <title>` 헤더 치환. 나머지 placeholder·섹션은 **보존** — 추측해서 채우지 말 것.
|
|
- **단, §8.0 Work Item Registry 의 예시 데이터 행은 제거**하고 헤더+구분선만 남긴 뒤 그 아래 `<!-- /project-spec 가 채움: WI-<PROJECT>-NNN | feature-<slug> | 측정가능 완료조건 | DEC-...@revision | WI dependency | planned -->` 주석으로 대체. 예시 행을 실제 row 로 오인하지 않게 한다.
|
|
- project-note 는 cluster 의 root 이므로 Parent upward link 불요(자기 자신이 hub).
|
|
|
|
4. **사용자 안내**
|
|
- 파일 경로 출력.
|
|
- "이제 `/project-spec <slug> <프로젝트 목표>` 로 깊은 조사를 채우세요." 안내.
|
|
|
|
## 규칙
|
|
|
|
- **스캐폴딩만**. 내용을 추측해서 채우지 말 것 (채움은 `/project-spec`).
|
|
- Project Decision Registry 와 Work Item Registry skeleton 을 삭제하지 말 것 — `/project-spec` 가 v2 handoff 로 채운다.
|
|
- project-note 는 머지/완료 후에도 raw 에 **영구 보관**. verified 사실만 `/ingest` 로 `wiki/projects/` 에 추출.
|
|
- `wiki/log.md` 는 기록하지 않음 (`/branch` 와 동일 정책).
|