flow-completer_skill

Overview

This skill marks tasks and phases complete after verifying all required work, tests, and documentation are finished. It enforces completion gates so nothing is forgotten before advancing work. Use it to update task/phase status, update the dashboard, and report summary to stakeholders.

How this skill works

The skill inspects task files (.flow/phase-N/task-M.md) and phase directories to read statuses, iterations, and action items. It runs a verification checklist: ensure iterations are complete (or cancelled/deferred), action items are checked, documentation updated, and no blockers remain. On pass it updates the task file and DASHBOARD.md, advances the current work pointer, and returns a concise report; on fail it lists incomplete items and suggests next actions.

When to use it

• When you want to finish a specific task ("Mark task complete")
• When you want to close a phase after all tasks are done ("Mark phase complete")
• After verifying all iterations or action items are finished
• When documentation and verification entries are updated
• When you need a clear report and dashboard update after completion

Best practices

• Always run full verification before marking complete (iterations/action items, docs, blockers)
• Update both the task file and DASHBOARD.md so project state stays consistent
• Treat cancelled or deferred work as documented non-blocking items
• Advance the current work pointer after completion to avoid stale pointers
• Report a short summary listing completed, cancelled, and deferred items

Example use cases

• User requests: "Finish this task" → verify iterations, update task status, update dashboard, report next work
• User requests: "Mark Phase 2 complete" → list tasks in phase, confirm no pending tasks, mark phase and advance to next phase
• Task with mixed iterations (complete + deferred) → pass verification and mark task complete while documenting deferred items
• Task blocked by external dependency → fail verification, report blocked iteration and propose unblock/cancel/defer options