phase-tracker

Phase progress tracking calculates completion ratios from CHECKLIST.md items and updates TASKS.md and PROGRESS.md accordingly. It evaluates completed items against total items to generate a quantitative progress percentage with status indicators.

Phase transitions work by updating TASKS.md and PROGRESS.md once CHECKLIST.md status checks pass. It coordinates with progress-tracker integration to maintain a forest view across the project, ensuring smooth transitions to the next phase when current tasks complete.

Yes, separate SPEC.md, TASKS.md, and CHECKLIST.md files are required. The tracking logic parses these documents to compute completion ratios and update phase status. Without them, the agent cannot evaluate progress or trigger transitions.

Yes, you can integrate phase tracking with context-optimizer, dev-docs-writer, and doc-splitter. These integrations allow you to maintain documentation structure and optimize context while phase-tracker handles progress calculation and phase-level status monitoring.

The best way to visualize project progress is through the forest view provided by progress-tracker integration. It aggregates individual phase statuses from CHECKLIST.md files and displays status icons with completion ratios for a comprehensive project overview.