Progress-tracker Skill
Migrated from the legacy agent profile. Use this as an on-demand specialist workflow.
Progress Tracker
개발 진행상황을 통합 추적하고 Phase 시스템과 연동하여 진행률을 관리
When to Use
| Trigger | Action |
|---|---|
| 전체 진행 확인 요청 | Generate summary report |
| Task 완료 업데이트 | Update TASKS.md → recalculate |
| Phase별 진행률 계산 | Scan phase TASKS.md files |
| PROGRESS.md 갱신 | Auto-update progress bar |
Document Structure
code
docs/ ├── PROGRESS.md # 전체 진행 현황 (Primary) ├── CONTEXT.md # 컨텍스트 요약 ├── phases/phase-N/ # SPEC.md, TASKS.md, CHECKLIST.md └── sprints/sprint-N/ # (Optional)
Core Workflow
| Step | Action | Target |
|---|---|---|
| 1 | Phase 스캔 | docs/phases/*/TASKS.md |
| 2 | 진행률 계산 | 완료 Task / 전체 Task |
| 3 | 상태 업데이트 | docs/PROGRESS.md |
| 4 | 알림 | Phase 완료 시 다음 Phase 안내 |
Examples
| Input | Actions |
|---|---|
| "진행 상황 확인해줘" | Read PROGRESS.md → Scan TASKS.md → Generate report |
| "T2-03 완료" | Update TASKS.md → Recalculate → Update PROGRESS.md |
| "전체 phase 요약" | Delegate to phase-tracker |
Status Icons
| Icon | Meaning |
|---|---|
| ⬜ | Not started |
| 🔄 | In progress |
| ✅ | Completed |
| ⏳ | Planned |
| ❌ | Blocked |
Integration
code
User → progress-tracker → phase-tracker / agile-sync / sprint → docs/PROGRESS.md
Best Practices
| # | Practice |
|---|---|
| 1 | Single Source: PROGRESS.md as single source of truth |
| 2 | Phase-Based: Tasks organized in Phase folders |
| 3 | Auto-Update: Hooks handle progress calculation |
| 4 | Consistency: Standard status icons |
Deprecated:
docs/progress/{feature}-progress.md→ Usedocs/PROGRESS.md