solo-dev-kitlisted
Install: claude install-skill Stophyuk/solutionzip-skills
# 1인 개발 틀
혼자 클로드 코드로 제품을 만들 때 세션마다 되풀이되는 세 가지를 파일로 막는다. 왜 이렇게 하는지는 `why.md`.
1. **상태는 문서에 적지 않고 파일에서 계산한다.** 세션 시작 훅이 git과 대장 셋을 읽어 요약을 매번 새로 만든다.
2. **실수는 그 일을 맡은 파일의 '지난 실수' 절에 적는다.** `/record`가 먼저 묻는다. 다음 세션에 그 파일이 열리면 같이 읽힌다.
3. **푸시 전 게이트.** `git push` 직전에 빠른 검사를 돌려 첫 실패에서 막는다.
## 깔리는 것
| 파일 | 하는 일 |
|---|---|
| `.claude/hooks/session-start.mjs` | 세션 머리 요약. 경로 · 절 이름은 맨 위 `CONFIG` 하나에. 파일이 없으면 그 줄은 건너뛴다 |
| `.claude/hooks/pre-push.mjs` | 푸시 게이트. package.json scripts에서 `preflight` · `typecheck` · `lint` 중 있는 것만 돌린다 |
| `.claude/skills/record/SKILL.md` | `/record <제목>` — 실수 · 결정 · 마일스톤 · 변경 기록을 물어 갱신하고 docs 커밋 |
| `.claude/rules/example.md` | 경로별 규칙 본보기(`paths:` frontmatter) |
| `CLAUDE.md` | `CLAUDE.md.example`에서. 프로젝트에 CLAUDE.md가 없을 때만 |
| `docs/milestones.md` · `decisions.md` · `changelog.md` | 빈 대장 셋 |
| `.claude/settings.json` | `settings.hooks.json`의 훅 셋을 기존 설정에 합친다 |
## 순서 — "1인 개발 틀 깔아줘"
1. **훑기.** 프로젝트를 먼저 본다 — CLAUDE.md · README에 상태 문장("어디까지 됐다")이 있는지, 이미 대장 구실을 하는 문서(TODO · ROADMAP · 결정 기록)가 있는지, package.json scripts, `.claude/settings.json`의 기존 훅.
2. **계획 보여 주기.** `node <이 폴더>/install.mjs <프로젝트>` — 아무것도 쓰지 않고 계획만 낸다. 이것을 정리해 사용자에게 보여 준다.
- 새로 깔 파일 / 이미 있어 그대로 둘 파일(`같음` · `다름` · CLAUDE.md의 빠진 절)
- settings.json에 보탤 훅
- 푸시 게이트가 돌릴 명령. **`검사 없음`이면 그렇게 말하고** 어떤 검사를 붙일지 묻는다(scripts에 추가하거나 `pre-push.mjs`의 `EXTRA`)
- 이미 있는 문서를 대장으로 쓸지(그러면 경로 · 절 이름을 `CONFIG`에 맞춘다), 새 대장을 깔지 묻는다.
3. **확인 받으면 깔기.** `node <이 폴더>/install.mjs <프로젝트> --apply`.
- 있는 파일은