| name | smaqit.task-complete |
| description | Mark a task as completed with verification. Use when finishing tasks to update status and verify criteria. |
| metadata | {"version":"0.2.0"} |
Task Complete
Mark a task as done with the format: task.complete [id]
Steps
- Load workflow rules by reading references/RULES.md
- Read the task file to review acceptance criteria and task mode
- Check task mode enforcement:
- Assisted mode: Verify this is user-invoked (not AI self-completion)
- Autonomous mode: AI may self-complete after verification
- Verify all criteria are met - Do NOT complete if any criteria remain unfinished
- Check off completed acceptance criteria (
- [x])
- Update task file status to "Completed" and add completion date
- Move task from Active table to appropriate destination in
.smaqit/tasks/PLANNING.md:
- Completed if successfully finished
- Abandoned if superseded, no longer relevant, or incorrect approach (include reason)
Mode-Aware Enforcement
Assisted Mode Tasks
CRITICAL: Assisted-mode tasks require user approval before completion.
Agent behavior:
- ⛔ Agent MUST NOT invoke task-complete for assisted tasks
- ✅ Agent implements the solution
- ✅ Agent provides completion summary
- ✅ Agent instructs user to run
/task.complete [id] when ready
Example agent response:
"Implementation complete. This is an assisted-mode task requiring your approval. Please review the changes and run /task.complete 003 when satisfied."
Autonomous Mode Tasks
Agent behavior:
- ✅ Agent implements the solution
- ✅ Agent verifies ALL acceptance criteria
- ✅ Agent MAY invoke task-complete autonomously
- ✅ Agent documents completion rationale
Example agent response:
"All acceptance criteria verified. Task 005 completed autonomously."
Requirements
- CRITICAL: All acceptance criteria MUST be verified as complete (for Completed tasks)
- CRITICAL: Check task mode before completing (read references/RULES.md)
- Do NOT mark as Completed if criteria remain unfinished
- Do NOT complete assisted-mode tasks without user invocation
- Use Abandoned (not Completed) for tasks being superseded or discontinued
- Update both the individual task file AND the
.smaqit/tasks/PLANNING.md file
- For Abandoned tasks, document the reason in
.smaqit/tasks/PLANNING.md
Task Mode Detection
Check the task file for mode metadata:
**Mode:** Assisted | Autonomous
- If mode is missing, assume Assisted (default)
- Mode is set by
task-start skill
Central Planning File
Remember: .smaqit/tasks/PLANNING.md contains three sections (Active, Completed, Abandoned) and must be updated when completing or abandoning tasks.
