Tasks.md Sprint Sync

Use this skill to keep a project's TASKS.md section aligned with whatever phase is marked IN PROGRESS in that project's PLAN.md.

What this skill does

• Reads the active phase from PLAN.md (phase with **Status: IN PROGRESS**)
• Extracts bullets from that phase's ### Work section
• Finds the target project section in TASKS.md
• Reports drift between plan work items and ### In progress tasks
• Optionally updates TASKS.md to match plan phase + work items

Inputs

Required:

• PROJECT_NAME (the exact heading in TASKS.md, e.g. ClawHub Skills)

Optional:

• PLAN_FILE (default: PLAN.md)
• TASKS_FILE (default: TASKS.md)
• SYNC_MODE (report or apply, default: report)

Run

Dry-run drift report:

PROJECT_NAME="ClawHub Skills" \
PLAN_FILE=projects/clawhub-skills/PLAN.md \
TASKS_FILE=TASKS.md \
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Apply sync to TASKS.md:

PROJECT_NAME="ClawHub Skills" \
PLAN_FILE=projects/clawhub-skills/PLAN.md \
TASKS_FILE=TASKS.md \
SYNC_MODE=apply \
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Run against included fixtures:

PROJECT_NAME="Demo Project" \
PLAN_FILE=skills/tasks-md-sprint-sync/fixtures/PLAN.sample.md \
TASKS_FILE=skills/tasks-md-sprint-sync/fixtures/TASKS.sample.md \
SYNC_MODE=apply \
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Output contract

• Exit 0 when report/apply completes
• Exit 1 on invalid inputs, missing sections, or no active phase
• In report mode: prints missing/extra task drift, no file changes
• In apply mode: updates Current phase + replaces In progress list for the target project section