Sync

Ocupación

Categorías

Scripting

Steps

1. Scan all task files:

   .context/tasks/*.md
   .context/tasks-done/**/*.md  (for reference/reporting, includes epic subfolders)
   

2. Extract from each:

   • Task number and name
   • Current status
   • Source epic/investigation (from "from:" note or context)
   • Any blockers noted
   • Acceptance criteria completion (count - [x] vs - [ ])

3. Fix stale task statuses: For each task in .context/tasks/:

   • If ALL ACs are [x] but status is NOT done → update status to done
   • If SOME ACs are [x] and status is pending → update status to in-progress
   • Report every status correction made

4. Archive done tasks:

   • Determine the source epic/investigation name for each done task
   • Create .context/tasks-done/<epic-name>/ subfolder if it doesn't exist (e.g., tasks-done/epic-auth-frontend/)
   • If task has no associated epic, use tasks-done/other/
   • Move any task with ## Status: done from tasks/ to the appropriate subfolder
   • Preserve original filename

5. Compare with progress.md:

   • Find mismatches
   • Find tasks in progress.md but no file
   • Find task files not in progress.md

6. Update progress.md:

   • Move tasks to correct sections
   • Add missing tasks
   • Remove orphaned entries
   • Done tasks remain in "Done" section (reference tasks-done/)

7. 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 done → update status to "completed" and move the file to (create folder if needed, preserve original filename)

If logging is enabled, append one line to ${CLAUDE_PLUGIN_DATA}/ctx-logs/sync-history.jsonl:

{"ts": "ISO-8601", "project": "name", "tasks_done": N, "tasks_pending": N, "tasks_blocked": N, "epics_completed": ["epic-name"]}

11. Report:

Sync complete.

Status Corrections:
- 007-build-ui.md: pending → in-progress (3/5 ACs checked)
- 008-write-tests.md: in-progress → done (all ACs checked)

Archived Tasks:
- 005-implement-auth.md → tasks-done/epic-authentication/
- 006-add-tests.md → tasks-done/epic-authentication/

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) — archived to plans-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 (archived to plans-done/)

Tasks:

• pending → Not started (in tasks/)
• in-progress → Being worked on (in tasks/)
• done → Finished (moved to tasks-done/<epic-name>/)
• blocked → Waiting on dependency (in tasks/)

Notes

• Done tasks are archived to keep tasks/ folder focused on active work
• Completed epics and investigations are archived to plans-done/ to keep plans/ and investigations/ focused on active work
• Archived files retain their original naming for traceability
• Use tasks-done/ and plans-done/ to review past work or reference implementations
• The /ctx:task skill should only look in tasks/ for active work

Gotchas

• Never delete archived files: tasks-done/ and plans-done/ are permanent archives. Moving files there is correct; deleting them is not.
• Auto-status correction can surprise users: If ACs are all checked but status says "in-progress", sync will correct to "done". Warn the user when this happens.
• Domain freshness check may produce false positives: A stale domain.md doesn't always mean it's wrong — the epic may not have changed business logic. Present the finding but don't insist on updates.
• Missing progress.md is recoverable: If it doesn't exist, create it from template and scan all task files to rebuild state. Do not error out.
• Epic archival is gated on ALL tasks done: Do not archive an epic to plans-done/ if any of its tasks are still pending or in-progress.