Project Progress Management

VerifiedSafe

Queries and updates project progress using the /progress command. Automatically analyzes source code (files in src/) and Git history to update PROGRESS.md with completed, in-progress, and pending tasks.

Sby Skills Guide Bot
ProductivityBeginner
506/2/2026
Claude Code
#progress#project-management#status#automation

Recommended for

Our review

Views and updates project progress via a PROGRESS.md file.

Strengths

  • Provides a visual summary with percentage and icons.
  • Automatically updates tasks based on code analysis.
  • Uses Git history and directory structure to detect changes.

Limitations

  • Only detects predefined file patterns.
  • Does not analyze file contents, only existence.
  • Depends on presence and specific format of PROGRESS.md.
When to use it

Ideal for keeping track of project milestones and tasks in an automated way.

When not to use it

Avoid for complex project management requiring dependencies and detailed manual tracking.

Security analysis

Safe
Quality score82/100

Uses only safe read-only operations (git log, file glob/grep) and local file editing. No network, no destructive commands, no code injection risk.

No concerns found

Examples

Check current progress
/progress
Update progress after changes
/progress update

allowed-tools: [Read, Edit, Bash, Glob, Grep] description: "프로젝트 진행 상황 조회, 업데이트, 분석"

/progress - 프로젝트 진행 상황 관리

사용법

/progress              — 현재 진행 상황 조회
/progress update       — 코드 상태 분석 후 PROGRESS.md 자동 업데이트

실행 흐름

조회 (인자 없음)

  1. PROGRESS.md 파일을 읽는다
  2. 완료/진행 중/대기 항목 수를 집계한다
  3. 진행률(%)과 함께 요약을 출력한다
  4. 진행 중 항목을 ▶ 마커와 함께 나열한다 (없으면 생략)
  5. 대기 항목을 번호와 함께 나열한다
  6. 최근 변경 이력 3건을 표시한다

업데이트 (update 인자)

  1. git log --oneline -10으로 최근 커밋을 확인한다
  2. src/ 디렉토리를 Glob/Grep으로 분석하여 실제 구현 상태를 파악한다:
    • src/stores/.ts 파일이 있으면 → Zustand 스토어 완료
    • src/components/.tsx 파일이 있으면 → UI 컴포넌트 완료
    • src/screens/.tsx 파일이 있으면 → 화면 구현 완료
    • src/hooks/.ts 파일이 있으면 → 훅 구현 완료
  3. 분석 결과에 따라 PROGRESS.md의 체크리스트를 업데이트한다:
    • 완료된 항목: [ ][x], 해당 섹션을 "완료"로 이동
    • 새로 발견된 작업이 있으면 "대기"에 추가
  4. 변경 이력 테이블에 오늘 날짜와 변경 내용을 추가한다
  5. 업데이트된 내용을 요약 출력한다

출력 형식

📊 프로젝트 진행 상황
━━━━━━━━━━━━━━━━━━
완료: N개 | 진행 중: N개 | 대기: N개
진행률: ██████░░░░ XX%

진행 중:
  ▶ 게임 루프 통합

대기 작업:
  1. UI 컴포넌트 (common/, game/)
  2. 화면 구현 (MainMenu, Game, RunResult, MetaShop)

최근 변경:
  2026-02-08  프로젝트 초기 설정 + 게임 엔진 구현
Related skills