CWM : Claude With Me
Claude Code 플러그인으로 Plan-승인-개발 워크플로우를 제공하는 하네스.
Claude와 함께 계획하고, 판단하세요!
(토큰 관리 최적화 for Claude Pro Users)
Installation
1. 마켓플레이스 등록 (최초 1회)
/plugin marketplace add https://github.com/HSUNEH/dev_sys_template
2. 플러그인 설치
/plugin install cwm
⚠️ 설치 후 반드시 Claude Code를 종료(
exit)하고 다시 시작하세요.
/reload-plugins로는 skills가 인식되지 않습니다. 재시작 후/cwm:setupwithme가 정상 동작합니다.
3. HUD 설치 (선택)
/cwm:custom_command
상태줄에 CWM 전용 HUD를 표시합니다:
📂 my-app | 🔀 main | ▓▓▓░░░░░░░ 28% | 🔧12 🤖2 ⚡3 | 📋 user-auth | ██░ 26m:65%
| 항목 | 설명 |
|---|---|
📂 my-app | 현재 작업 폴더 |
🔀 main | Git 브랜치 |
▓▓▓░░░░░░░ 28% | 컨텍스트 사용량 |
🔧12 🤖2 ⚡3 | tool / agent / skill 호출 횟수 |
📋 user-auth | 현재 활성 플랜 이름 (.cwm/docs/plans/ 기반) |
██░ 26m:65% | 5h 리밋 (남은 시간 : 사용 퍼센티지) |
사용법
/cwm:setupwithme ← 최초 1회, 프로젝트 초기화
┌─────────────────────────────────┐
│ /cwm:planwithme {작업명} │ ← 플랜 세우기
│ ↓ │
│ 승인 → /compact → 구현 │ ← 작업 진행
│ ↓ │
│ 완료 → 다음 작업 │ ← 반복
└─────────────────────────────────┘
1. 초기화 (최초 1회)
> /cwm:setupwithme
5단계 위저드로 .cwm/config.yml, 개발 매뉴얼, CLAUDE.md를 생성합니다.
2. planwithme → 구현 반복
> /cwm:planwithme 로그인-기능
→ PLAN.md, CONTEXT.md, CHECKLIST.md 생성
→ 승인 → /compact → 구현 시작
→ 완료 → /cwm:planwithme 다음-작업
간단한 수정은 플랜 없이 바로 진행됩니다:
| 방법 | 예시 |
|---|---|
| 그냥 요청 | 이 변수 이름 바꿔줘 → 바로 진행 |
간단: 접두어 | 간단: 로고 교체해줘 → 플랜 우회 |
플랜 없이 3개+ 파일 수정 시 plan-enforcer가 자동 차단합니다.
3계층 강제 시스템
| 계층 | 메커니즘 | 역할 |
|---|---|---|
| 1 | CLAUDE.md 규칙 | Claude가 큰 작업 전 자발적으로 "플랜 세울까요?" 물어봄 |
| 2 | change-logger | 모든 변경을 .cwm/docs/logs/change-log.md에 무출력으로 기록 |
| 3 | plan-enforcer | 플랜 없이 3개+ 파일 수정 시 차단 (PreToolUse, exit 2) |
모든 훅은
/cwm:setupwithme로 초기화된 프로젝트에서만 동작합니다.
What You'll See
CWM 훅이 동작하면 상태줄에 표시됩니다:
⠋ CWM: plan check ← Edit/Write 전 플랜 확인 중
⠋ CWM: logging ← 변경사항 자동 기록 중
⠋ CWM: quality check ← 세션 종료 시 품질 검사 중
플랜 없이 3개 이상 파일을 수정하면 차단됩니다:
⛔ [CWM] 플랜 없이 3개 파일을 수정하려 합니다
/cwm:planwithme {작업명} → 플랜을 먼저 세우세요
"간단: {요청}" → 플랜 없이 계속 진행
세션 종료 시 이슈가 있으면 알려줍니다:
⚠️ [CWM] 2 issues found — fix directly
[ESLint] src/auth.ts:
12:5 error 'token' is defined but never used
[Security] src/db.ts:
8: const password = "admin123"
플랜 상태 관리
.status 파일로 안정적 관리:
.cwm/docs/plans/{작업명}/
├── PLAN.md # 구현 계획
├── CONTEXT.md # 결정 근거
├── CHECKLIST.md # 작업 추적
└── .status # pending → active → complete
Features
Skills
| 명령어 | 설명 |
|---|---|
/cwm:setupwithme | 프로젝트 초기화 5단계 위저드 |
/cwm:planwithme | 3문서 + .status 생성, 승인 워크플로우 |
/cwm:dev-manual | 작업 유형별 개발 매뉴얼 챕터 참조 |
/cwm:custom_command | CWM HUD 설치 (상태줄에 플랜 상태 표시) |
Hooks
| Hook | Event | Description |
|---|---|---|
| plan-enforcer | PreToolUse | 플랜 없이 3개+ 파일 수정 시 차단 |
| change-logger | PostToolUse | 모든 변경사항 자동 기록 |
| completion-checker | Stop | 세션 종료 시 린트/타입/보안 검사 |
Agents
| 에이전트 | 역할 | 트리거 |
|---|---|---|
| qa-agent | 코드 검토, 오류 수정, 보고서 작성 | 린트 에러 4건+ |
| test-agent | 테스트 작성/실행, 오류 진단 | 테스트 필요 시 |
| planning-agent | 계획 수립/검토, 문서 작성 | 기획 필요 시 |
Project Structure (after setup)
your-project/
├── .cwm/
│ ├── config.yml Hook 동작 설정
│ ├── dev-manual/chapters/ 개발 가이드 (6챕터)
│ ├── docs/
│ │ ├── plans/{작업명}/ 계획 문서 (PLAN, CONTEXT, CHECKLIST, .status)
│ │ ├── logs/change-log.md 변경 이력
│ │ └── reports/ 에이전트 보고서
│ ├── state/ 훅 내부 상태
│ └── .initialized 초기화 완료 마커
└── CLAUDE.md CWM 워크플로우 규칙
Configuration
.cwm/config.yml에서 설정 변경 가능:
plan_enforcer:
threshold: 3 # 플랜 없이 수정 가능한 파일 수
completion_check:
threshold_immediate_fix: 3 # 즉시 수정 권장 이슈 수
threshold_agent_recommend: 4 # qa-agent 위임 권장 이슈 수
general:
require_plan: true # 플랜 강제 글로벌 토글
Requirements
- Claude Code CLI
jq(hooks에서 사용, 없으면 hooks 자동 스킵)
License
MIT