feat: 공식 문서 근거자료, 브랜치 기능 문서 작성
This commit is contained in:
DongHyeonka
@@ -1,6 +1,6 @@
|
||||
# LLM Wiki — 작업 가이드
|
||||
|
||||
원본 자료(`raw/`)를 **검증된 실무 기술 문서**로 바꾸고, 거기서 면접·블로그·포트폴리오 같은 외부 산출물을 만들어 내는 **문서 파이프라인**입니다. Obsidian vault 이자 Claude Code 자동화 저장소입니다.
|
||||
원본 자료(`raw/`)를 검증된 실무 기술 문서로 바꾸는 문서 파이프라인입니다. 거기서 면접·블로그·포트폴리오 같은 외부 산출물을 만들어 냅니다. Obsidian vault 이자 Claude Code 자동화 저장소입니다.
|
||||
|
||||
처음 오셨다면 이 README만 읽으면 작업을 시작할 수 있습니다. 운영 규칙의 전체 정의(SSOT)는 [CLAUDE.md](CLAUDE.md) 에 있습니다.
|
||||
|
||||
@@ -15,9 +15,9 @@ wiki/projects = 내 프로젝트에 적용된 검증 사실
|
||||
wiki/interview·blog·portfolio = 위 canonical 에서 파생된 외부 산출물
|
||||
```
|
||||
|
||||
이 순서는 거꾸로 갈 수 없습니다. 외부 산출물은 **반드시** `wiki/concepts` 또는 `wiki/projects` 를 거쳐서 나옵니다. raw나 메모에서 바로 블로그·면접 문서를 만들지 않습니다.
|
||||
이 순서는 거꾸로 갈 수 없습니다. 외부 산출물(블로그·면접 문서 등)은 raw나 메모에서 바로 만들지 않고 **반드시** `wiki/concepts` 또는 `wiki/projects` 를 거쳐서 나옵니다.
|
||||
|
||||
또 하나의 원칙은 **근거 없는 단정을 쓰지 않는다**입니다. 모든 결정은 출처(Claim ID)를 가지거나, 근거가 없으면 `UNSUPPORTED_DECISION` 으로 솔직히 표시합니다.
|
||||
또 하나의 원칙은 **근거 없는 단정을 쓰지 않는다**입니다. 모든 결정은 출처(Claim ID)로 뒷받침하거나 근거가 없으면 `UNSUPPORTED_DECISION` 으로 솔직히 표시합니다.
|
||||
|
||||
---
|
||||
|
||||
@@ -61,9 +61,9 @@ wiki/interview·blog·portfolio = 위 canonical 에서 파생된 외부 산출
|
||||
```
|
||||
|
||||
1. **캡처** — 하루는 `/daily` 로, 새 작업은 `/branch <slug>` 로 시작합니다. 슬러그는 *무엇을 구현하는지* 를 영문 kebab-case 4~8단어로 적습니다(`feature-`, `fix-`, `chore-`, `experiment-` 중 하나로 시작). 번호 계층(`-1`, `-2`)은 쓰지 않습니다.
|
||||
2. **근거 조사** — 공식 문서·대기업 블로그 URL 을 저장하면 원문에서 핵심 인용을 그대로(verbatim) 발췌하고 실제 존재하는지 `grep` 으로 검증한 뒤 `raw/` 에 보관합니다. 각 자료는 `Claims Extracted` 표(Claim ID 가 붙은 사실 목록)를 갖습니다.
|
||||
3. **노트 채움** — `/branch-spec` 이 source 의 Claim 에서 결정과 대안을 채우고, 근거가 없으면 **먼저 자동으로 공식 문서·대기업 블로그를 조사**합니다. 그래도 없으면 추측하지 않고 `UNSUPPORTED_DECISION` 으로 표시합니다. 마지막에 `/depth` 가 자동으로 돌아 **Ready / Not ready** 를 판정합니다. Ready 일 때 코딩을 시작하면 구현 중 되묻을 일이 없습니다.
|
||||
4. **wiki 승급** — 구현이 끝나고 `status_label` 을 `review` 나 `merged` 로 올린 뒤 `/ingest` 를 실행하면, 검증된(`actually-implemented` 이상) 결과만 `wiki/projects/` 로 추출됩니다.
|
||||
2. **근거 조사** — 공식 문서·대기업 블로그 URL 을 저장하면 원문에서 핵심 인용을 그대로(verbatim) 발췌합니다. 실제 존재하는지 `grep` 으로 검증한 뒤 `raw/` 에 보관합니다. 각 자료에는 `Claims Extracted` 표(Claim ID 가 붙은 사실 목록)가 있습니다.
|
||||
3. **노트 채움** — `/branch-spec` 이 source 의 Claim 에서 결정과 대안을 채우고 근거가 없으면 먼저 자동으로 공식 문서·대기업 블로그를 조사합니다. 그래도 없으면 추측 대신 `UNSUPPORTED_DECISION` 으로 표시합니다. 마지막에 `/depth` 가 자동으로 돌아 **Ready / Not ready** 를 판정합니다. Ready 일 때 코딩을 시작하면 구현 중 되묻을 일이 없습니다.
|
||||
4. **wiki 승급** — 구현이 끝나면 `status_label` 을 `review` 나 `merged` 로 올립니다. 그 뒤 `/ingest` 를 실행하면 검증된(`actually-implemented` 이상) 결과만 `wiki/projects/` 로 추출됩니다.
|
||||
5. **외부 산출물** — canonical 문서가 `reviewed` 이상이면 `/interviewize`·`/blogify` 로 면접 답변·블로그 초안을 만듭니다. 본문 문체는 [rules/prose-style.md](rules/prose-style.md) 를 따릅니다(존댓말, 적당히 긴 길이, 개발 용어만 영어).
|
||||
|
||||
---
|
||||
@@ -108,7 +108,7 @@ wiki/interview·blog·portfolio = 위 canonical 에서 파생된 외부 산출
|
||||
직접 신경 쓰지 않아도 다음이 자동으로 동작합니다.
|
||||
|
||||
- **저장 전 차단** — 근거 구조(Claims Extracted, Decision Evidence Map)를 우회하는 저장을 막습니다.
|
||||
- **저장 후 검사** — 깨진 link 는 항상 경고합니다. 섹션 누락·빈 선택조건 같은 *완성도* 검사는 문서를 `review`·`merged` 로 **완성 선언했을 때만** 합니다(작성 중에는 방해하지 않습니다).
|
||||
- **저장 후 검사** — 깨진 link 는 항상 경고합니다. 섹션 누락·빈 선택조건 같은 *완성도* 검사는 문서를 `review`·`merged` 로 완성 선언했을 때만 하므로 작성 중에는 방해하지 않습니다.
|
||||
|
||||
전체 검사는 언제든 직접 돌릴 수 있습니다.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user