task_tool_finalize

Tool Finalize Command - Complete Remaining Implementation Work

YOUR ROLE: ORCHESTRATOR ONLY

YOU ARE THE ORCHESTRATOR. You must NOT write any code, read files for implementation, or make any edits yourself. Your ONLY job is to call the Task tool to spawn specialized subagents in sequence. If you find yourself writing code or editing files, STOP — you are doing it wrong. Delegate everything.

When to Use This Command

Use /task_tool_finalize when:

• /task_complete reached the 5-cycle limit but didn't achieve 100% completion
• Quality reviewer marked implementation as NEEDS_REVISION in final cycle
• Lint or TypeScript errors remain after initial implementation
• Build passes but still has warnings or validation bypasses

---

SETUP

$ARGUMENTS contains the path to an existing task directory from a previous /task_complete run.

Set TASK_DIRECTORY = $ARGUMENTS. Verify it contains: plan.md, context.md, validation-tracking.json.

---

STEP 1 — CALL Task tool: tc-context-gatherer

IMMEDIATELY call the Task tool with these parameters.

• subagent_type: tc-context-gatherer
• description: "Analyze remaining work"
• prompt:

  Task directory: {TASK_DIRECTORY}
  Mode: FINISH_MODE
  
  Read all existing files in {TASK_DIRECTORY}/ — implementation reports, review reports,
  validation-tracking.json. Identify all remaining lint errors, TypeScript errors, and
  build issues with exact file locations. Save to {TASK_DIRECTORY}/finish-context.md with:
  - Current completion percentage
  - Specific errors remaining (file:line format)
  - Priority order for fixes
  

BLOCKING GATE: Do NOT proceed to Step 2 until the Task tool call returns.

---

STEP 2–3 — Error-Fixing Loop (Maximum 20 cycles)

Set cycle = 1. Target: zero errors, clean build.

STEP 2 — CALL Task tool: tc-implementation-agent

IMMEDIATELY call the Task tool with these parameters.

• subagent_type: tc-implementation-agent
• description: "Fix errors (finalize cycle {cycle})"
• prompt:

  Task directory: {TASK_DIRECTORY}
  Mode: FINISH_MODE
  Cycle: {cycle}
  
  Read {TASK_DIRECTORY}/finish-context.md for the list of remaining errors.
  Fix ONLY lint errors, TypeScript errors, and build issues. Do NOT add new features.
  Work through errors systematically. Run npm run lint and npm run build after each fix.
  Save output to {TASK_DIRECTORY}/finish-lint-{cycle}.txt and {TASK_DIRECTORY}/finish-build-{cycle}.txt.
  Update {TASK_DIRECTORY}/validation-tracking.json with current error counts.
  Save report to {TASK_DIRECTORY}/finish-implementation-{cycle}.md.
  
  Target state: lint_errors = 0, typescript_errors = 0, build_success = true