progress-tracker
Track and report progress across autonomous coding sessions. Use when generating progress reports, calculating metrics, visualizing completion, or estimating time to completion.
SKILL.md
Full skill instructions
Progress Tracker
Tracks and reports progress across autonomous coding sessions with metrics, visualization, and completion estimation.
Quick Start
Get Progress Metrics
from scripts.progress_tracker import ProgressTracker
tracker = ProgressTracker(project_dir)
metrics = tracker.get_progress()
print(f"Features: {metrics.passing}/{metrics.total}")
print(f"Progress: {metrics.percentage:.1f}%")
Generate Report
report = tracker.generate_report(format="markdown")
print(report)
Visualize Progress
visualization = tracker.visualize_progress()
print(visualization)
# ████████████░░░░░░░░ 60% (30/50)
Progress Dashboard
┌─────────────────────────────────────────────────────────────┐
│ PROGRESS DASHBOARD │
├─────────────────────────────────────────────────────────────┤
│ │
│ Overall Progress │
│ ████████████████░░░░░░░░░░░░░░░░░░░░ 45% │
│ │
│ Features: 45/100 passing │
│ Sessions: 12 completed │
│ Commits: 87 made │
│ │
│ By Category │
│ ├─ auth: ████████████████████ 100% (5/5) │
│ ├─ crud: ██████████████░░░░░░ 70% (14/20) │
│ ├─ ui: ████████░░░░░░░░░░░░ 40% (12/30) │
│ ├─ api: ██████████████████░░ 90% (9/10) │
│ ├─ testing: ██░░░░░░░░░░░░░░░░░░ 10% (2/20) │
│ └─ other: ██████░░░░░░░░░░░░░░ 30% (3/10) │
│ │
│ Estimated Completion │
│ ├─ At current rate: ~15 sessions remaining │
│ ├─ Time estimate: ~7.5 hours │
│ └─ Sessions per day: 3 │
│ │
└─────────────────────────────────────────────────────────────┘
Metrics Tracked
| Metric | Description |
|---|---|
| Features | Passing/total feature count |
| Progress % | Completion percentage |
| Sessions | Number of sessions completed |
| Commits | Number of git commits |
| Velocity | Features per session |
| ETA | Estimated sessions to completion |
Integration Points
- context-state-tracker: Reads feature and progress data
- coding-agent: Tracks feature completion
- autonomous-loop: Uses metrics for continuation decisions
References
references/METRICS.md- Detailed metrics documentationreferences/REPORT-FORMATS.md- Report format options
Scripts
scripts/progress_tracker.py- Core ProgressTracker classscripts/metrics_calculator.py- Metrics calculationsscripts/report_generator.py- Report generationscripts/visualization.py- ASCII visualization
