Skip to main content

Task Completion Workflow

Standardized workflow ensuring every task completion includes evidence collection, verification, and proper documentation.

Workflow Overview

┌─────────────────────────────────────────────────────────────────┐
│ TASK COMPLETION WORKFLOW │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ START │──▶│ EXECUTE │──▶│ COLLECT │──▶│ VERIFY │ │
│ │ TASK │ │ TASK │ │ EVIDENCE │ │ QUALITY │ │
│ └──────────┘ └──────────┘ └──────────┘ └────┬─────┘ │
│ │ │
│ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │COMPLETE │◀──│ UPDATE │◀──│ LOG │◀──│ PASS? │ │
│ │ │ │ PLAN │ │ SESSION │ │ │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘

Workflow Phases

Phase 1: Task Start

Trigger: Task assigned or started

Actions:

  1. Register task in tracking system
  2. Record start timestamp
  3. Identify expected outcomes
  4. Note context sources being used

Hook: H.P.005-HOOKS/task-completion.py --task X.Y.Z --event task.started

Phase 2: Task Execution

Trigger: Work begins

Actions:

  1. Execute task according to plan
  2. Log significant decisions
  3. Track progress updates
  4. Document any blockers or issues

Phase 3: Evidence Collection

Trigger: Task work completed

Required Evidence:

Evidence TypeDescriptionRequired
Files createdList with sizes/hashesYes
Tests addedCount and coverageFor code tasks
Plan updateCheckbox markedYes
Session logEntry addedYes

Phase 4: Quality Verification

Trigger: Evidence collected

Command:

/quality-gate --task E.1.1

Quality Checks:

  • File exists at expected path
  • Tests implemented (if code task)
  • Plan updated with [x] checkbox
  • Session log entry created

Phase 5: Session Logging

Trigger: Quality gate passed

Session Log Format:

### YYYY-MM-DDTHH:MM:SSZ - Task X.Y.Z Completed

- **Task:** X.Y.Z - Description
- **Status:** ✅ COMPLETED
- **Agent:** agent-name
- **Duration:** X minutes

**Evidence:**
- File: path/to/file.py (lines)
- Tests: N methods

Phase 6: Plan Update

Trigger: Session logged

Actions:

  1. Mark task complete in PILOT plan
  2. Update progress percentage
  3. Unblock dependent tasks

Phase 7: Completion

Trigger: Plan updated

Hook:

python H.P.005-HOOKS/task-completion.py --task E.1.1 --event task.complete

Exit Criteria

Task is complete when ALL conditions met:

  • All expected outcomes achieved
  • Evidence collected and documented
  • Quality gate passed
  • Session log entry created
  • PILOT plan updated with [x] checkbox

Workflow Version: 1.0.0 Created: 2026-01-02 Author: CODITECT Process Refinement