planwithme

CWM 계획 관리

모든 개발 작업은 계획 수립 → 승인 → 실행 순서를 따른다.

⚠️ 프로젝트 루트 결정 (필수)

플랜 생성/조회 전에 반드시 프로젝트 루트를 먼저 결정한다:

1. 현재 작업 디렉토리(CWD)부터 상위로 올라가며 .cwm/.initialized 파일을 찾는다
2. .cwm/.initialized가 존재하는 디렉토리가 프로젝트 루트이다
3. 모든 플랜 경로는 이 프로젝트 루트의 절대 경로 기준으로 생성한다

# 프로젝트 루트 찾기 예시
PROJECT_ROOT=$(pwd)
while [ "$PROJECT_ROOT" != "/" ]; do
  [ -f "$PROJECT_ROOT/.cwm/.initialized" ] && break
  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
done
# 못 찾으면 setupwithme 필요
[ -f "$PROJECT_ROOT/.cwm/.initialized" ] || echo "ERROR: .cwm not initialized"

⛔ 절대 금지:

• 상대 경로(.cwm/docs/plans/...)만으로 파일을 생성하지 않는다
• CWM 플러그인 소스 디렉토리 안에 플랜을 생성하지 않는다
• .cwm/.initialized를 찾지 못하면 사용자에게 /cwm:setupwithme 실행을 안내한다

⚠️ cd 주의:

• git push 등 Bash 작업 중 cd로 하위 디렉토리에 진입한 경우, 플랜 파일 조작 전에 반드시 프로젝트 루트로 돌아오거나, 절대 경로를 사용한다
• CWD가 프로젝트 루트가 아닐 수 있으므로, 항상 .cwm/.initialized 기준으로 루트를 재확인한다

실행 흐름

1. 사용자 작업 지시
       │
       ▼
2. 계획 수립 (이 스킬)
   ├── 요구사항 분석
   ├── 기존 코드 조사
   └── 구현 전략 설계
       │
       ▼
3. 4파일 생성 → .cwm/docs/plans/{YYMMDD}-{작업명}/
   ├── PLAN.md         계획서
   ├── CONTEXT.md      맥락 노트
   ├── CHECKLIST.md    체크리스트
   └── .status         "pending"
       │
       ▼
4. ⛔ 반드시 멈춤
   ├── 계획 요약 표시
   └── 사용자 승인 대기
       │
       ▼
5. 승인 시:
   ├── .status → "active"
   ├── CHECKLIST 승인 체크
   └── /compact 안내 → 구현 시작

3문서 + .status 작성 규칙

PLAN.md (계획서)

# [작업명] 계획서

## 개요
- 목적 (한 줄)
- 범위 (영향 파일/모듈)
- 예상 단계 수

## 현재 상태 분석
- 기존 코드 구조
- 변경 필요 부분

## 구현 계획
### Phase 1: [단계명]
- 구체적 작업 내용
- 예상 변경 파일

### Phase 2: [단계명]
...

## 기술 선택
- 라이브러리/패턴 + 선택 이유

## 리스크
- 예상 문제 + 대응 방안

CONTEXT.md (맥락 노트)

# [작업명] 맥락 노트

## 결정 기록
| 결정 사항 | 선택지 | 최종 선택 | 이유 |
|-----------|--------|-----------|------|

## 참조 자료
- 관련 문서/URL
- 참고 코드 위치

## 제약 조건
- 기술적/비즈니스 제약

## 사용자 요구사항 원문
> (사용자 지시 그대로)

CHECKLIST.md (체크리스트)

# [작업명] 체크리스트

## 작업 목록
- [ ] Phase 1: [단계명]
  - [ ] 세부 작업 1
  - [ ] 세부 작업 2
- [ ] Phase 2: [단계명]
  - [ ] 세부 작업 1

## 컨텍스트 전환 체크
- [ ] 사용자 승인 완료
- [ ] /compact 안내 출력 완료

## 품질 체크
- [ ] 에러 처리 적용
- [ ] 보안 검토
- [ ] 테스트 작성/통과

.status 파일

플랜 상태를 나타내는 단일 키워드 파일:

• pending — 생성됨, 승인 대기
• active — 승인됨, 진행 중
• complete — 작업 완료

echo "pending" > {프로젝트 루트}/.cwm/docs/plans/{YYMMDD}-{작업명}/.status

문서 저장 위치

{프로젝트 루트의 절대 경로}/.cwm/docs/plans/{YYMMDD}-{작업명}/
├── PLAN.md
├── CONTEXT.md
├── CHECKLIST.md
└── .status

• 프로젝트 루트 = .cwm/.initialized가 존재하는 디렉토리 (위의 "프로젝트 루트 결정" 참조)
• 폴더명 = YYYYMMDD-작업명 (예: 260330-user-auth, 260330-api-refactor)
• 작업명은 kebab-case
• 한 작업 = 한 폴더, 4파일이 항상 세트
• 파일 생성 시 반드시 절대 경로 사용 (예: /Users/me/my-project/.cwm/docs/plans/260330-user-auth/PLAN.md)

승인 대기

3문서 생성 후 반드시 요약을 보여주고 멈춘다:

📋 계획 수립 완료 — 검토 요청

📂 .cwm/docs/plans/{YYMMDD}-{작업명}/
  ├── PLAN.md       ← 전체 구현 계획
  ├── CONTEXT.md    ← 결정 근거
  ├── CHECKLIST.md  ← 작업 체크리스트
  └── .status       ← pending

[계획 요약]
  Phase 1: {단계1}
  Phase 2: {단계2}
  ...

⏸️ 검토 후 승인해주세요. 승인 전까지 코드를 작성하지 않습니다.

⛔ 절대 금지: 이 메시지 출력 후 같은 턴에서:

• 코드 파일을 읽거나 수정하지 않는다
• Bash 명령을 실행하지 않는다
• 사용자의 다음 메시지까지 대기한다

승인 처리

사용자가 "확인", "승인", "진행", "좋아", "ㅇㅇ", "ㄱㄱ", "ok", "go" 등 동의하면:

Step 1: 상태 변경

echo "active" > {프로젝트 루트}/.cwm/docs/plans/{YYMMDD}-{작업명}/.status

CHECKLIST.md의 "사용자 승인 완료" 체크:

- [x] 사용자 승인 완료

Step 2: /compact 안내 후 멈춤

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 계획이 승인되었습니다
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📂 .cwm/docs/plans/{YYMMDD}-{작업명}/.status → active


컨텍스트를 정리하면 더 원활합니다.

👉 /compact 후 "계속" 이라고 입력하세요.
   (바로 진행하려면 "계속 진행" 이라고 입력하세요)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CHECKLIST.md 체크:

- [x] /compact 안내 출력 완료

⛔ 이 메시지 출력 후 이 턴에서 어떤 도구도 호출하지 않는다.

Step 3: 구현 시작 (다음 턴 또는 /compact 후)

사용자가 돌아오면 (반드시 이 순서를 따른다):

1. 프로젝트 루트를 다시 결정한다 — .cwm/.initialized 파일을 찾아 절대 경로 확인
2. {프로젝트 루트}/.cwm/docs/plans/ 아래에서 .status가 active인 플랜 폴더를 찾는다
3. 해당 폴더의 PLAN.md와 CHECKLIST.md를 파일에서 다시 읽는다 (대화 히스토리 의존 X)
4. /cwm:dev-manual로 관련 챕터 참조
5. Phase 1부터 순서대로 구현 (이미 체크된 항목은 건너뜀)
6. 각 세부 작업 완료 시 CHECKLIST.md 업데이트

작업 완료

모든 Phase 완료 시:

echo "complete" > {프로젝트 루트}/.cwm/docs/plans/{YYMMDD}-{작업명}/.status

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ {작업명} 완료
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

.cwm/docs/plans/{YYMMDD}-{작업명}/.status → complete

중요 규칙

1. 계획 먼저 — 코드 한 줄 전에 3문서부터
2. 승인 필수 — 같은 턴에서 코드 작성 금지
3. .status로 추적 — pending/active/complete
4. 실시간 갱신 — CHECKLIST.md 계속 업데이트
5. 맥락 보존 — 새 세션에서도 .cwm/docs/plans/ 읽으면 이어서 가능