phase-tracker

Automate phase-level progress tracking across SPEC.md, TASKS.md, and CHECKLIST.md.

1|Updated Feb 5, 2026
Ready to run
npx skills add https://github.com/tygwan/ultra-codex-init --skill phase-tracker
๐Ÿ’ฌ Prompt for ChatGPT / Claude Chatโ–ผ
Please help me install this Agent Skill.
Skill: phase-tracker
Source: https://github.com/tygwan/ultra-codex-init/tree/main/.codex/skills/phase-tracker
Command: npx skills add https://github.com/tygwan/ultra-codex-init --skill phase-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Phase๋ณ„ ๊ฐœ๋ฐœ ์ง„ํ–‰์ƒํ™ฉ ์ถ”์  ๋ฐ ๊ด€๋ฆฌ ์—์ด์ „ํŠธ๋กœ, ๋‹จ์ผ phase์˜ ์ƒํƒœ๋ฅผ ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋ชจ๋‹ˆํ„ฐ๋งํ•˜๊ณ  phase ๊ฐ„ ์ „ํ™˜ ๋ฐ ์ฒดํฌ๋ฆฌ์ŠคํŠธ ๊ฒ€์ฆ์„ ์ž๋™ํ™”ํ•ฉ๋‹ˆ๋‹ค.

Core Features & Use Cases

  • Phase ๋ฌธ์„œ ํŠธ๋ฆฌ ๋ทฐ๋ฅผ ํ†ตํ•ด SPEC.md, TASKS.md, CHECKLIST.md ๊ธฐ๋ฐ˜์˜ phase ์ƒํƒœ๋ฅผ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
  • ์ง„ํ–‰๋ฅ  ๊ณ„์‚ฐ(์™„๋ฃŒ ํ•ญ๋ชฉ / ์ด ํ•ญ๋ชฉ)๊ณผ ์ƒํƒœ ์•„์ด์ฝ˜ ํ‘œ์‹œ๋ฅผ ํ†ตํ•ด phase์˜ ์ง„ํ–‰ ์ƒํ™ฉ์„ ํ•œ ๋ˆˆ์— ํŒŒ์•…ํ•ฉ๋‹ˆ๋‹ค.
  • progress-tracker์™€์˜ ์—ฐ๋™์œผ๋กœ ์ „์ฒด ํ”„๋กœ์ ํŠธ์˜ forest view๋ฅผ ์œ ์ง€ํ•˜๊ณ , ํ•„์š” ์‹œ ๋‹ค์Œ phase๋กœ์˜ ์›ํ™œํ•œ ์ „ํ™˜์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.

Quick Start

Create a new phase folder and begin tracking progress by populating SPEC.md, TASKS.md, and CHECKLIST.md.

Frequently Asked Questions about phase-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track development phase progress using SPEC.md and TASKS.md files?โ–ผ

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.

How does phase transition work when managing task checklists across multiple development phases?โ–ผ

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.

Do I need separate markdown files for SPEC, TASKS, and CHECKLIST to use phase progress tracking?โ–ผ

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.

Can I integrate phase tracking with context-optimizer and doc-splitter for documentation workflows?โ–ผ

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.

What is the best way to visualize project progress across multiple development phases?โ–ผ

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.