feat: 공식 문서 근거자료, 브랜치 기능 문서 작성

This commit is contained in:
DongHyeonka
2026-07-29 18:05:17 +09:00
parent cfd84875bf
commit 58515ab0f3
251 changed files with 31470 additions and 109 deletions
+45
View File
@@ -0,0 +1,45 @@
---
description: "개념 문서를 내 프로젝트 적용 문서로 변환"
---
사용자가 `/projectize <concept 문서 경로>` 를 입력하면 아래 절차를 수행한다.
`wiki/concepts/`의 일반 개념 문서를 **내 프로젝트 적용 문서**로 변환합니다.
**대상:** <concept 문서 경로>
## 작업 절차
1. **개념 문서 읽기**
- `wiki/concepts/<...>.md`의 Summary / Standard / Sources 파악
2. **관련 프로젝트 식별**
- 내 프로젝트 자료(`wiki/projects/`, `raw/project-notes/`)에서 이 개념이 등장하는 곳 검색
- 관련 프로젝트가 없으면 사용자에게 어느 프로젝트와 연결할지 물어봄
3. **증거 등급 판정**
- 관련 프로젝트에서 이 개념이 어떤 등급으로 존재하는지 판정. **등급 어휘는 CLAUDE.md §6 프로젝트 증거 등급표가 SSOT** — 인라인 재나열 금지.
- 모든 진술에 §6 등급 라벨을 붙인다.
4. **project 문서 생성** (`rules/naming-conventions.md` §2.11 nested 구조)
- 대상 경로: `wiki/projects/<project-slug>/<concept-topic>.md`**nested**, hyphenated flat (`<project>-<concept>.md`) 금지
- `<project-slug>``raw/project-notes/<project-slug>.md` 의 슬러그와 일치 (cluster 정합성)
- `<concept-topic>` 은 그 프로젝트 안에서 이 concept 의 적용 측면을 표현 (kebab-case, 4~6 단어)
- 예: `wiki/projects/keycloak-patterns/oidc-handshake-application.md` (NOT `wiki/projects/keycloak-patterns-oidc-handshake.md`)
- 프로젝트의 wiki sub-hub: sibling **named hub** `wiki/projects/<project-slug>.md` (folder-note 패턴, MOC) — 새 토픽 생성 시 hub 의 sub-doc 목록에도 등재. `index.md` 사용 금지 (`rules/linking-rules.md` §12).
- `templates/wiki-project-template.md` 적용
- "실제 구현 / 로컬 검증 / 문서·계획 / 면접 가능 범위 / 과장 금지" 섹션을 사실 기반으로 채움
- 추측이나 일반화는 적지 않음
5. **양방향 링크**
- 원본 concept 문서의 "Project Application" 섹션에 새 project 문서를 `[[...]]`로 연결
- 새 project 문서의 "관련 개념"에 원본 concept를 `[[...]]`로 연결
6. **로그 기록**
- `wiki/log.md`: `YYYY-MM-DD HH:mm /projectize — <concept> → <project>`
## 규칙
- **개념 문서의 일반론을 내가 한 것처럼 옮기지 말 것.**
- 사실 확인이 안 되는 부분은 `needs-confirmation`으로 두고 사용자에게 질문.
- 면접에서 말할 수 있는 범위와 말하면 안 되는 부분을 **반드시** 분리.