Sync Progress
Update progress.md to match actual task file statuses, archive completed tasks, and update epic/investigation statuses based on task completion.
Folder Structure
code
.context/ ├── tasks/ # Active tasks (pending, in-progress, blocked) ├── tasks-done/ # Archived completed tasks ├── plans/ # Epics ├── investigations/ # Investigation files └── progress.md # Progress tracker
Steps
- •
Scan all task files:
code.context/tasks/*.md .context/tasks-done/*.md (for reference/reporting)
- •
Extract from each:
- •Task number and name
- •Current status
- •Source epic/investigation (from "from:" note or context)
- •Any blockers noted
- •
Archive completed tasks:
- •Create
.context/tasks-done/if it doesn't exist - •Move any task with
## Status: completedfromtasks/totasks-done/ - •Preserve original filename
- •Create
- •
Compare with progress.md:
- •Find mismatches
- •Find tasks in progress.md but no file
- •Find task files not in progress.md
- •
Update progress.md:
- •Move tasks to correct sections
- •Add missing tasks
- •Remove orphaned entries
- •Completed tasks remain in "Completed" section (reference tasks-done/)
- •
Update epic/investigation statuses:
- •Check
.context/plans/for epics with status "broken-down" - •Check
.context/investigations/for investigations with status "broken-down" - •For each broken-down epic/investigation:
- •Find all tasks that belong to it (check both tasks/ and tasks-done/)
- •If ALL tasks are completed → update status to "completed"
- •Keep as "broken-down" if any tasks are pending/in-progress
- •Check
- •
Report:
code
Sync complete. Archived Tasks: - 005-implement-auth.md → tasks-done/ - 006-add-tests.md → tasks-done/ Task Changes: - [task] moved to [section] - [task] added (was missing) - [task] removed (no file) Epic/Investigation Updates: - [epic-name] status changed to "completed" (all 5 tasks done) Current state: - Done: X (in tasks-done/) - In Progress: X - Pending: X - Blocked: X
Status Lifecycle
Epics/Investigations:
- •
draft→ Being written - •
ready→ Ready to break down - •
broken-down→ Has tasks, work in progress - •
completed→ All tasks finished
Tasks:
- •
pending→ Not started (in tasks/) - •
in-progress→ Being worked on (in tasks/) - •
completed→ Done (moved to tasks-done/) - •
blocked→ Waiting on dependency (in tasks/)
Notes
- •Completed tasks are archived to keep
tasks/folder focused on active work - •Archived tasks retain their original numbering for traceability
- •Use
tasks-done/to review past work or reference implementations - •The
/ctx:taskskill should only look intasks/for active work