name: task-finish-contract description: Enforce task completion with explicit Goal/Progress/Next state. Prevent mid-task stalls and ensure evidence-based completion.

Task Finish Contract

Prevent mid-task stalls. Every task must finish with explicit state and evidence.

Problem

Agents often:

• Stop mid-task without explanation
• Output plans without execution
• Lack clear completion criteria
• Missing evidence artifacts

Workflow

1. State Output (Each Substantial Step)

**Goal**: What finished looks like
**Progress**: What has been done
**Next**: One concrete action executing now

2. Completion Proof Format

For tasks with 2+ steps, include:

**DONE_CHECKLIST**:
- [ ] Item 1 completed
- [ ] Item 2 completed

**EVIDENCE**:
- Executed: command/action summary
- Artifact: path/URL/id
- Verified: check command result

**NEXT_AUTONOMOUS_STEP**:
- One follow-up that runs without user input

3. Anti-Stall Rule

• Planning-only replies: max 1
• Next reply MUST contain execution evidence
• Never end with "I will now..." without tool result

Executable Completion Criteria

Privacy/Safety

• No sensitive data in completion evidence
• Artifact paths use relative or workspace paths
• No credentials in task logs

Self-Use Trigger

Use when:

• Starting any multi-step task
• Resuming after interruption
• Handoff to another agent

Finish what you start. Prove it with evidence.