getedgehq/workplan

워크플랜 스킬

워크플랜은 자동 압축(compaction) 후에도 유지되는 타임스탬프가 포함된 마크다운 파일입니다. 다단계 작업을 위한 당신의 외부 두뇌 역할을 합니다.

파일 규칙

• 위치: 프로젝트 루트, gitignore 대상
• 이름: WORKPLAN-YYYYMMDD-슬러그.md (예: WORKPLAN-20260228-인증-리팩터.md)
• 작업/단계당 하나의 파일. 이전 워크플랜을 재사용하지 마세요. 각 작업마다 새로 시작하세요.

작업

생성 (/workplan 또는 /workplan create)

1. 먼저 읽기. 계획을 작성하기 전에 관련 파일, 이슈, 컨텍스트를 모두 읽습니다.

2. .gitignore에 WORKPLAN-*.md가 포함되어 있는지 확인 (없으면 추가).

3. 계획 작성 전 범위 모드 선택:

   • EXPANSION: "10점 만점 버전은 무엇인가?" 크게 꿈꾸고 범위를 확장합니다.
   • HOLD: "이것을 완벽하게 만든다." 범위는 적절하고, 엄격성을 극대화합니다.
   • REDUCTION: "가치를 전달하는 최소한의 것은 무엇인가?" 과감하게 축소합니다.

   기본값: 새로운 기능 = EXPANSION, 버그 수정/출시 준비 = HOLD, 시간 제약 = REDUCTION.

4. 다음 템플릿으로 파일 생성:

# Work Plan: [제목]

Created: YYYY-MM-DD HH:MM
Last updated: YYYY-MM-DD HH:MM
Status: IN PROGRESS
Mode: HOLD / EXPANSION / REDUCTION

## Context

[이 작업이 필요한 이유. 문제. 근본 원인. 주요 제약 사항. 이슈/PR 링크.]

## Roadmap

- [ ] 1. 단계 설명
- [ ] 2. 단계 설명
- [ ] 3. 단계 설명

## Decisions

[아키텍처 또는 접근 방식 결정 사항을 타임스탬프와 함께 기록]
- [HH:MM] Z 때문에 X 대신 Y 선택

## Discovered Issues

[작업 중 원래 범위에 없던 발견 사항]
- [HH:MM] 2단계 작업 중 ... 발견

## Verification Log

[완료된 각 항목의 검증 기록]
- [HH:MM] Step 1: VERIFIED - `npm test` 실행, 42개 테스트 전부 통과
- [HH:MM] Step 3: VERIFIED - 로그인 플로우 수동 테스트, OAuth 및 이메일 모두 정상 작동

업데이트 (/workplan update)

1. 프로젝트 루트의 활성 WORKPLAN-*.md 파일을 읽습니다.
2. "Last updated" 타임스탬프를 업데이트합니다.
3. 완료된 항목을 검증 타임스탬프와 함께 체크합니다.
4. 새로운 발견 사항이나 결정 사항을 추가합니다.
5. 현재 상태를 사용자에게 보고합니다.

마감 (/workplan close)

1. 활성 워크플랜을 읽습니다.
2. 모든 항목이 검증 타임스탬프와 함께 체크되었는지 확인합니다.
3. 최종 검증(빌드, 테스트, 수동 확인)을 실행합니다.
4. 상태를 DONE으로 변경합니다.
5. 최종 요약을 추가합니다:

## Completed

Closed: YYYY-MM-DD HH:MM
모든 N개 항목이 구현 및 검증되었습니다. 빌드 통과. 테스트 통과.

재개 (압축 후)

컨텍스트가 압축되었거나 어디까지 진행했는지 확실하지 않을 때:

1. 프로젝트 루트에서 WORKPLAN-*.md 파일을 찾습니다.
2. 워크플랜 파일을 읽습니다.
3. 첫 번째 미체크 항목을 식별합니다.
4. 그 지점부터 계속 진행합니다.

규칙

1. VERIFIED는 테스트 완료를 의미합니다. "작동할 것 같다"가 아닙니다. 실제로 실행하고, 통과를 확인한 후 검증 표시를 합니다. 실행한 내용과 결과를 포함하세요.
2. 모든 변경 시 타임스탬프를 업데이트하세요. 미래의 당신(압축 후)이 이 정보에 의존합니다.
3. 새로운 발견 사항은 즉시 기록하세요. 컨텍스트에만 남겨두지 마세요.
4. 사용자가 작업 완료를 확인할 때까지 계획을 절대 삭제하지 마세요.
5. 체크리스트 항목당 하나의 관심사. 큰 단계는 더 작은 검증 가능한 조각으로 나누세요.
6. 단계 검증에 실패하면, 실패를 기록하고, 체크하지 않은 상태로 유지하며, 무엇이 잘못되었는지 추가하세요.