Files
my-lotto/.claude/commands/docs/update-roadmap.md
hyeonggil 41f98ee917 🧑‍💻 dx: Claude Code 에이전트·명령어·훅 설정 추가
- agents/: dev(코드리뷰, 앱개발, UI 등), docs(PRD), notion 전문 에이전트
- commands/: git(commit/branch/merge/pr), docs 커스텀 명령어
- hooks/: notification-hook, stop-hook 알림 스크립트
- settings.local.json: MCP 서버 활성화 및 훅 설정 추가
2026-03-15 15:03:19 +09:00

3.8 KiB

description, allowed-tools
description allowed-tools
ROADMAP.md에서 완료된 작업을 체크하고 진행 상황을 업데이트합니다
Read(docs/ROADMAP.md:*)
Edit(docs/ROADMAP.md:*)

Claude 명령어: Update Roadmap

완료된 작업을 ROADMAP.md에 체크하고 진행 상황을 업데이트합니다.

사용법

/update-roadmap

프로세스

  1. ROADMAP.md 파일 읽기
  2. 사용자에게 완료한 Task 번호 확인
  3. 해당 Task와 하위 체크리스트에 체크 표시 추가
  4. Phase 진행 상황 업데이트
  5. 문서 버전 및 최종 업데이트 날짜 갱신
  6. 진행 상황(X/12 Tasks 완료) 업데이트

업데이트 규칙

Task 체크 패턴

Task 제목 업데이트:

  • Before: - **Task XXX: 작업명** - 우선순위
  • After: - **Task XXX: 작업명** ✅ - 완료

하위 항목 업데이트:

  • Before: - 항목명
  • After: - ✅ 항목명

Phase 상태

  • 모든 Task 완료 시: ### Phase N: 제목### Phase N: 제목 ✅

진행 상황 업데이트

  • 완료된 Task 수 / 전체 Task 수 계산
  • 진행 상황 라인 업데이트

날짜 업데이트

  • 최종 업데이트 날짜를 오늘 날짜로 자동 설정

대화형 프로세스

  1. 현재 ROADMAP.md 읽기
  2. 미완료 Task 목록 표시
  3. "어떤 Task를 완료했나요? (예: 004 또는 004,005)" 질문
  4. 사용자 입력 받기
  5. 해당 Task와 모든 하위 항목에 체크 추가
  6. Phase 상태 자동 확인 및 업데이트
  7. 진행 상황 통계 업데이트
  8. 변경 사항 확인 메시지 출력

구현 상세

Task 완료 체크 로직

  1. Task 제목 찾기: - **Task XXX: 패턴으로 검색
  2. 이미 완료 확인: 제목에 가 있으면 건너뜀
  3. 제목 업데이트: 우선순위를 완료로 교체
  4. 하위 항목 업데이트: Task 다음 줄부터 추가

Phase 완료 체크 로직

  1. Phase 내 모든 Task 확인
  2. 모든 Task에 가 있으면 Phase 제목에도 추가
  3. 단, 이미 가 있는 Phase는 건너뜀

진행 상황 계산

전체 Task: 001~012 (12개)
완료 Task: ✅ 표시가 있는 Task 개수
진행률: (완료 Task / 전체 Task) * 100

예시

Before:

- **Task 004: 공통 컴포넌트 라이브러리 구축** - 우선순위
  - shadcn/ui 설치 및 설정
  - 기본 UI 컴포넌트 추가
  - 더미 견적서 데이터 생성 유틸리티

**📅 최종 업데이트**: 2025-10-07
**📊 진행 상황**: Phase 1 완료 (3/12 Tasks 완료)

After:

- **Task 004: 공통 컴포넌트 라이브러리 구축** ✅ - 완료
  - ✅ shadcn/ui 설치 및 설정
  - ✅ 기본 UI 컴포넌트 추가
  - ✅ 더미 견적서 데이터 생성 유틸리티

**📅 최종 업데이트**: 2025-10-08
**📊 진행 상황**: Phase 2 진행 중 (4/12 Tasks 완료)

주의사항

  • Task 번호는 3자리 숫자 형식 (001, 002, 003...)
  • 이미 완료된( 표시가 있는) Task는 건너뜀
  • Phase 전체 완료 시 Phase 제목에도 추가
  • 날짜는 YYYY-MM-DD 형식 사용
  • 여러 Task 동시 완료 지원 (004,005,006)

스마트 기능

  1. 자동 Phase 진행 추적

    • Phase 1 완료
    • Phase 2 진행 중
    • Phase 4 대기 중
  2. 완료율 계산

    • 전체 12개 Task 중 완료 개수 자동 카운트
    • Phase별 완료 Task 수 추적
  3. 날짜 자동 갱신

    • 오늘 날짜로 자동 업데이트 (YYYY-MM-DD)

사용 예시

# 커맨드 실행
/update-roadmap

# 출력 예시:
현재 미완료 Task 목록:
- Task 004: 공통 컴포넌트 라이브러리 구축
- Task 005: 견적서 조회 페이지 UI 구현
- Task 006: 에러 및 로딩 상태 UI 구현
...

어떤 Task를 완료했나요? (예: 004 또는 004,005): 004

✅ Task 004 완료 체크 완료!
📊 진행 상황: 4/12 Tasks 완료 (33%)