Claude Workflow Kit

claude-workflow-kit

[Claude Code](https://code.claude.com/docs) 개인 워크플로 스킬과 훅을 **GitOps**로 관리하는 플러그인 마켓플레이스다. `~/.claude/skills`에 직접 파일을 복사하는 대신, 이 repo를 SoT로 두고 `settings.json` 선언으로 설치·동기화한다.

담긴 플러그인

설치 후 스킬은 플러그인 이름으로 네임스페이스된다. `git-workflow`는 `workflow-core`의 스킬을 부르므로 그것에 의존한다(설치 시 자동으로 함께 설치·활성화됨). `ko-style`은 어느 쪽에도 의존하지 않고, 스킬이 아니라 훅이라 부르는 명령이 없다. 켜 두면 턴이 끝날 때마다 스스로 돈다.

플러그인	명령	설명
workflow-core	/workflow-core:work-cycle	작성-리뷰 사이클을 완주해 완성본으로 제시
workflow-core	/workflow-core:coding-standards	코드를 쓸 때 지키고 리뷰할 때 확인하는 기준 카탈로그
workflow-core	/workflow-core:docs-standards	프로젝트 문서/주석 작성·배치·정리 기준
workflow-core	/workflow-core:refs-scratch	.refs/ 스크래치 디렉터리 규약 (임시파일 위치·이름·gitignore)
workflow-core	/workflow-core:pre-push	보호 브랜치(main/master) 직접 push 차단 훅 설치
git-workflow	/git-workflow:git-workflow	브랜치 + PR/MR 워크플로 (gh·glab)
ko-style	없음 (Stop 훅)	이번 턴에 고친 파일의 번역투를 턴이 끝나기 전에 알린다

스킬과 훅 사이의 의존은 [docs/architecture/component-dependency.md](docs/architecture/component-dependency.md)에 있다. `ko-style`의 동작과 사전은 [docs/architecture/ko-style.md](docs/architecture/ko-style.md)에 있다.

다른 환경에서 쓸 때 (충돌 가능 요소)

설치 전에 먼저 읽자. 이 킷의 스킬과 훅에는 nil-park의 워크플로·취향이 하드코딩돼 있다. 다른 사람이 그대로 가져가면 자신의 `CLAUDE.md`, 팀 규약, 개인 취향과 충돌할 확률이 높은 요소를, 충돌 확률 순으로 정리한다.

상 (거의 확실히 충돌)

| 요소 | 위치 | 왜 충돌 | 탈출구 | | ---------------------------------------------- | ------------------------ | ------------------------------------------