Menu
CWM 프로젝트 초기화 위저드. 프로젝트 비전 수집 → 기술 환경 분석 → 워크플로우 설정 → 초기 개발 계획 수립 → 환경 세팅까지 5단계로 완료한다.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
범용 요구사항 명확화 스킬. 모호한 요청을 Socratic Q&A로 3차원(Goal/Scope/Acceptance) 채점하며 명확성 임계값(20%)에 도달할 때까지 한 번에 한 질문씩. 단독 호출 가능하며 planwithme에서 자동 위임되기도 함.
개발 계획 수립 및 3문서 자동 생성. 새 작업 시작 전 반드시 실행하여 PLAN.md, CONTEXT.md, CHECKLIST.md + .status 파일을 생성한다.
ralph-loop 플러그인 stop-hook 의 세션 격리 버그(같은 프로젝트의 무관한 세션이 block 되는 문제)를 로컬에서 임시 패치한다. 업스트림 수정 전까지의 방어 조치.
활성 플랜의 Phase를 build-runner 에이전트에 위임해 구현+테스트를 일괄 수행. 사용자는 Phase별 요약만 받고 메인 컨텍스트는 깨끗하게 유지. .cwm/config.yml의 build 명령 우선, 없으면 프로젝트 매니페스트 추론.
Git 커밋 및 푸쉬. 작업 완료 후 반드시 프로젝트 루트로 복귀한다.
CWM HUD(StatusLine) 설치. 플랜 상태, 컨텍스트 바, 호출 카운트 등을 상태줄에 표시한다.
| name | setupwithme |
| description | CWM 프로젝트 초기화 위저드. 프로젝트 비전 수집 → 기술 환경 분석 → 워크플로우 설정 → 초기 개발 계획 수립 → 환경 세팅까지 5단계로 완료한다. |
| user-invocable | true |
/cwm:setupwithme하나로 프로젝트 개발 환경을 세팅한다. 5단계 대화형 위저드. 각 단계마다 사용자 확인 후 다음으로 진행.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 CWM 프로젝트 초기화를 시작합니다
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
5단계를 거쳐 개발 환경을 세팅합니다:
Phase 1 프로젝트 비전 ← 지금
Phase 2 기술 환경
Phase 3 워크플로우 설정
Phase 4 초기 개발 계획
Phase 5 환경 세팅 적용
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 Phase 1: 프로젝트에 대해 알려주세요
1. 프로젝트 이름은?
2. 한 문장으로 설명하면?
3. 현재 상태는? (아이디어 단계 / 기존 프로젝트에 적용)
4. 핵심 기능 3~5개
5. 첫 번째로 만들고 싶은 기능은?
답변 정리 후 확인. ⛔ 확인 전 다음 Phase로 넘어가지 않는다.
분석 대상:
├── package.json / pyproject.toml / go.mod → 기술 스택
├── 디렉토리 구조 → 레이아웃
├── .eslintrc / prettier / biome.json → 린터
├── tsconfig.json → 언어 설정
├── 테스트 파일 → 테스트 프레임워크
├── Dockerfile → 배포 환경
└── 기존 코드 샘플 → 네이밍/패턴 추론
📋 Phase 2: 기술 환경
1. 언어: (TypeScript / JavaScript / Python / Go / 기타)
2. 프레임워크: (Next.js / React / FastAPI / Express / 기타)
3. DB: (PostgreSQL / MongoDB / MySQL / SQLite / 없음)
4. 패키지 매니저: (npm / yarn / pnpm / pip / poetry)
5. 테스트: (Jest / Vitest / Pytest / 없음)
6. 린터: (ESLint+Prettier / Biome / Ruff / 없음)
⛔ 확인 후 다음 Phase.
📋 Phase 3: 개발 워크플로우
특별한 규칙이 있는 것만 답해주세요. 없으면 "기본".
[코딩 규칙]
1. 네이밍: (camelCase / snake_case / 기본)
2. import 순서: (특별한 규칙 있으면)
3. 코딩 컨벤션: (있으면 설명)
[에러 처리 & 보안]
4. 에러 처리 패턴: (커스텀 에러 / Result 패턴 / 기본)
5. 인증 방식: (JWT / Session / OAuth / 없음)
[프로세스]
6. Git 브랜치 전략: (GitHub Flow / trunk-based / 기본)
7. plan-enforcer 임계값: (기본 3파일 / 원하는 숫자)
⛔ 확인 후 다음 Phase.
Phase 1의 "첫 번째 기능"으로 3문서 생성:
.cwm/docs/plans/{YYMMDD}{NN}-{기능명-kebab-case}/
├── PLAN.md 계획서
├── CONTEXT.md 맥락 노트
├── CHECKLIST.md 체크리스트
└── .status "pending"
사용자에게 계획 요약을 보여주고 검토 요청. ⛔ 승인 전 Phase 5로 넘어가지 않는다. 이 승인은 계획 내용에 대한 승인이지 구현 시작이 아니다.
수집한 정보로 다음 파일들을 자동 생성:
프로젝트에 맞게 커스터마이징:
.cwm/dev-manual/chapters/01~06.md 생성:
| 챕터 | 사용 정보 |
|---|---|
| 01 project-overview | Phase 1 + Phase 2 |
| 02 coding-standards | Phase 3 + Phase 2 |
| 03 architecture | Phase 2 + Phase 1 |
| 04 error-handling | Phase 3 + Phase 2 |
| 05 security | Phase 3 + Phase 2 |
| 06 testing | Phase 2 + Phase 3 |
작성 규칙:
반드시 아래 템플릿 기반으로 프로젝트 루트에 생성:
# CLAUDE.md
## 이 프로젝트
- **이름**: {프로젝트명}
- **설명**: {한 줄 설명}
- **기술 스택**: {스택}
- **패키지 매니저**: {매니저}
## CWM 작업 규칙
1. **활성 플랜(🟡)이 없을 때 코드를 수정하기 전에 반드시 사용자에게 확인**
- 간단한 작업 → "바로 진행할게요" 확인 후 진행
- 큰 작업 → "/cwm:planwithme 로 플랜을 세울까요?" 제안
2. **"간단:", "바로:" 접두어 → 확인 없이 즉시 진행**
3. **활성 플랜이 있으면 → PLAN.md/CHECKLIST.md 따라 진행**
4. **한 턴에 계획과 구현을 동시에 하지 않는다**
## 디렉토리 규칙
- **프로젝트 루트**: `.cwm/.initialized` 파일이 존재하는 디렉토리. 모든 CWM 파일 경로는 이 위치 기준의 절대 경로를 사용한다.
- **`cd` 금지**: Bash로 `cd`를 사용한 경우(git 작업 등) 반드시 프로젝트 루트로 돌아온다. 또는 절대 경로만 사용하여 CWD 변경 없이 작업한다.
- **파일 생성 시 절대 경로 필수**: `.cwm/docs/plans/...` 같은 상대 경로 대신 `/full/path/to/project/.cwm/docs/plans/...` 형태로 사용한다.
## 컨텍스트 관리
- **계획 → 구현 전환 시**: `{프로젝트 루트}/.cwm/docs/plans/{YYMMDD}{NN}-{작업명}/`의 PLAN.md, CHECKLIST.md를 파일에서 다시 읽고 시작
- **새 세션 또는 /compact 후 이어서**: 먼저 `.cwm/.initialized`로 프로젝트 루트를 찾고, `.cwm/docs/plans/` 아래에서 .status가 "active"인 플랜을 찾아 CHECKLIST.md의 미체크 항목부터 이어서 진행
## 필수 워크플로우
1. `/cwm:planwithme`로 3문서 생성
2. 사용자 승인 대기 → .status를 "active"로 변경
3. `/cwm:dev-manual`로 관련 챕터 참조
4. Phase 순서대로 구현, CHECKLIST.md 실시간 업데이트
5. 완료 시 .status를 "complete"로 변경
## 서브에이전트
- **websearchwithme**: 웹 리서치 전문 (facet 분해 + 다중 쿼리 변형으로 GitHub/SO/Reddit/HN/공식 문서 조사). 디버깅·기술비교·베스트프랙티스 조사 시 Task로 위임
- **build-runner**: Phase 단위 구현+테스트+재시도 전문. buildwithme가 Phase마다 자동 위임해 메인 컨텍스트 오염 없이 실행
mkdir -p {프로젝트 루트}/.cwm/docs/plans {프로젝트 루트}/.cwm/docs/logs {프로젝트 루트}/.cwm/docs/reports
touch {프로젝트 루트}/.cwm/.initialized
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ CWM 세팅 완료!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
생성된 파일:
.cwm/config.yml ← Hook 설정
.cwm/dev-manual/chapters/ ← 개발 매뉴얼 6챕터
CLAUDE.md ← 프로젝트 규칙
.cwm/docs/plans/{첫기능}/ ← 초기 개발 계획 (🔴 대기)
다음 단계:
1. 초기 계획을 승인하면 구현을 시작합니다
2. 새 작업은 /cwm:planwithme 로 플랜을 먼저 세우세요
3. /cwm:dev-manual 로 개발 매뉴얼을 참조하세요
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━