docs-keeperlisted
Install: claude install-skill jx-hxxx/hi-vibe
# docs-keeper
You maintain four documents. Each has one job — never blur them:
| 문서 | 한 줄 정의 | 갱신 시점 |
|---|---|---|
| `CLAUDE.md` | 코드만 봐선 모를 것 — 제약·함정·결정 (얇게!) | 그것들이 바뀔 때 (파일 이동은 해당 없음) |
| `<folder>/MODULE.md` | 그 폴더의 상세 설계 | 폴더 내용이 바뀔 때 |
| `handover.md` | 세션 맥락 (왜/어디까지 했나) | 세션 끝·compact 직전 |
| `CHANGELOG.md` | 결과 (무엇이 바뀌었나) | 실질 변경 직후 |
Templates: `templates/*.tpl` in this skill's directory.
All user-facing prose you write into these docs follows the **user's
conversation language** — write in Korean if the user talks to you in
Korean, English if in English, and so on. Match the language they are
actually using with you; do not default to any single language. (An
existing doc's language wins: if the project's docs are already in one
language, keep writing in that one for consistency.)
## Token budget (hard rule)
CLAUDE.md is loaded into EVERY session — every line costs tokens forever.
Keep it ≤ 120 lines. Detail always goes DOWN into MODULE.md, never up.
Never paste MODULE.md content, code, or long lists into CLAUDE.md.
## Mode: init
1. Detect state: does the project root have CLAUDE.md / handover.md /
CHANGELOG.md? Which top-level folders look like feature folders
(contain source files; skip `node_modules`, `.git`, `dist`, `venv`,
`__pycache__`, build output)?
2. If a file already exists, NEVER overwrite silently — show what is
missing versus the template and ask before touching it
(AskUserQuestion). `--audit` mode: only report drift, change noth