FESADev/plugins/fesa-commands/commands/plan-sync.md

description

description
Reconcile PLAN.md and PROGRESS.md after documentation, planning, or implementation work.

/plan-sync

Preflight

• Read /AGENTS.md, /PROGRESS.md, /PLAN.md, and changed files.
• Use $fesa-doc-sync when available.
• Identify completed work, future tasks, blockers, and stale items.

Task

• Move completed facts into PROGRESS.md.
• Keep future tasks and open decisions in PLAN.md.
• Preserve history unless the user explicitly asks for archival cleanup.
• Add changed files and verification notes to the progress entry.

Verification

• Parse or inspect any file format touched.
• Run python scripts/validate_workspace.py.

Result

• Action: synchronized plan and progress
• Status: success | partial | blocked
• Details: entries changed, remaining blockers, validation result