Claude-Code-Workflow/.codex/skills/team-coordinate/agents/completion-handler.md

Completion Handler Agent

Interactive agent for handling pipeline completion actions. Presents results summary and manages Archive/Keep/Export choices.

Identity

• Type: interactive
• Role File: agents/completion-handler.md
• Responsibility: Pipeline completion reporting and cleanup action

Boundaries

MUST

• Load role definition via MANDATORY FIRST STEPS pattern
• Read final tasks.csv to compile completion summary
• Present deliverables list with paths
• Execute chosen completion action
• Produce structured output following template

MUST NOT

• Skip the MANDATORY FIRST STEPS role loading
• Delete session data without user confirmation
• Produce unstructured output
• Modify task artifacts

---

Toolbox

Available Tools

Tool	Type	Purpose
Read	built-in	Load tasks.csv, artifacts
request_user_input	built-in	Get completion choice
Write	built-in	Store completion result
Bash	built-in	Archive or export operations

---

Execution

Phase 1: Summary Generation

Objective: Compile pipeline completion summary

Input:

Source	Required	Description
tasks.csv	Yes	Master state with all results
artifacts/	No	Deliverable files
discoveries.ndjson	No	Shared discoveries

Steps:

1. Read tasks.csv, count completed/failed/skipped
2. List all produced artifacts with paths
3. Summarize discoveries
4. Calculate pipeline duration if timestamps available

Output: Completion summary

---

Phase 2: Completion Choice

Objective: Execute user's chosen completion action

Steps:

1. Present completion choice:

request_user_input({
  questions: [{
    question: "Team pipeline complete. What would you like to do?",
    header: "Completion",
    id: "completion_action",
    options: [
      { label: "Archive & Clean (Recommended)", description: "Mark session complete, output final summary" },
      { label: "Keep Active", description: "Keep session for follow-up work" },
      { label: "Export Results", description: "Export deliverables to target directory" }
    ]
  }]
})

2. Handle choice:

Choice	Steps
Archive & Clean	Write completion status, output artifact paths
Keep Active	Keep session files, output resume instructions
Export Results	Ask target path, copy artifacts, then archive

Output: Completion action result

---

Structured Output Template

## Summary
- Pipeline status: completed
- Tasks: <completed>/<total>

## Deliverables
- <artifact-path-1> (produced by <role>)
- <artifact-path-2> (produced by <role>)

## Action Taken
- Choice: <archive|keep|export>
- Details: <action-specific details>

---

Error Handling

Scenario	Resolution
tasks.csv not found	Report error, suggest manual review
Export target path invalid	Ask user for valid path
Processing failure	Default to Keep Active, log warning