feat: 가상화 문서들 추가

This commit is contained in:
DongHyeonka
2026-09-10 08:54:05 +09:00
parent e9f6a93327
commit 43e1aadef0
695 changed files with 153404 additions and 12754 deletions
+26 -2
View File
@@ -8,6 +8,8 @@
| 스킬 | 언제 |
|---|---|
| `running-tech-log-pipeline` | 코드베이스에서 Studio 저장까지 일곱 단계를 한 줄기로 돌릴 때. 단계마다 서브에이전트를 띄우고 런 원장에 남깁니다 |
| `publishing-tech-log-to-studio` | 다 쓴 기록을 Studio 에 넣고 저장할 때. Playwright MCP 를 쓰고 게시하지 않습니다 |
| `writing-tech-log-records` | Studio에 올릴 기록 한 건을 쓰거나 고칠 때. 종류 선택, 칸 채우기, 본문 작성, 게시 전 대조 |
| `rewriting-technical-prose-naturally` | 이미 쓴 문장이 AI가 쓴 것처럼 읽힐 때 |
| `writing-as-the-person-who-did-it` | 정확한데 아무도 쓰지 않은 보고서처럼 읽힐 때. 자료에 남은 사람의 흔적을 제자리에 놓습니다 |
@@ -39,11 +41,25 @@ Reference·Question·Decision의 칸은 평문으로 렌더링됩니다. 그런
작업 규칙과 보관 중인 문서 목록은 `CLAUDE.md`에 있습니다.
## 한 줄기로 실행할 때
`running-tech-log-pipeline` 이 일곱 단계(S1 SSOT → S2 분해 계약 → S3 기록 → S4 그림 →
S5 AI 티 → S6 목소리 → S7 Studio 저장)를 정의하고 단계마다 서브에이전트를 띄웁니다.
한 런은 `runs/<프로젝트>/<runId>/run.json` 에 원장을 남기고, 그 원장이 절차를 지켰는지는
따로 검사합니다.
```bash
python3 scripts/verify-pipeline-run.py runs/<프로젝트>/<runId>/run.json
```
단계가 빠졌는지, 그 단계가 자기 스킬을 실제로 열었는지(`skillEcho`), 관문이 통과했는지,
산출물이 디스크에 있는지를 봅니다.
## 보관 구조
`docs/` 아래를 프로젝트로 나눕니다. 프로젝트 문서는 그 폴더 밖에 두지 않습니다. 루트에는
`.agents`·`.claude`·`.codex`·`.playwright-mcp``CLAUDE.md`·`README.md`·`LICENSE`·`scripts/`
둡니다.
`.agents`·`.claude`·`.codex`·`.playwright-mcp`·`runs/`
`CLAUDE.md`·`README.md`·`LICENSE`·`scripts/`둡니다.
```text
docs/
@@ -123,6 +139,14 @@ python3 scripts/audit-records.py # 전부
python3 scripts/audit-records.py keycloak # 하나만
```
그림은 좌표까지 봅니다. lint는 관계만 보고 좌표를 안 봐서, 구역이 겹쳐 그려지거나 라벨이
상자에 먹혀도 통과합니다.
```bash
python3 scripts/check-figure-text.py <프로젝트> # <text>가 전부 이름인가
python3 scripts/check-figure-overlap.py <프로젝트> # 상자와 라벨이 겹치지 않는가
```
칸이 비었는지, `kind`와 폴더가 맞는지, `topic`이 폴더 slug인지, 본문 마커가 있는지,
`assets`·`evidence`가 가리키는 파일이 실제로 있는지, 본문이 부르는 자산이 frontmatter에
선언돼 있는지, 증거의 원문·메타·렌더가 짝을 이루는지를 봅니다. 문제가 있으면 종료 코드가