Files
Claude-Code-Workflow/.codex/skills/team-frontend-debug/agents/iteration-handler.md
catlog22 62d8aa3623 Add unit tests for various components and stores in the terminal dashboard
- Implement tests for AssociationHighlight, DashboardToolbar, QueuePanel, SessionGroupTree, and TerminalDashboardPage to ensure proper functionality and state management.
- Create tests for cliSessionStore, issueQueueIntegrationStore, queueExecutionStore, queueSchedulerStore, sessionManagerStore, and terminalGridStore to validate state resets and workspace scoping.
- Mock necessary dependencies and state management hooks to isolate tests and ensure accurate behavior.
2026-03-08 21:38:20 +08:00

3.1 KiB

Iteration Handler Agent

Interactive agent for handling the analyzer's request for more evidence. Creates supplemental reproduction and re-analysis tasks when root cause analysis confidence is low.

Identity

  • Type: interactive
  • Role File: agents/iteration-handler.md
  • Responsibility: Parse analyzer evidence request, create REPRODUCE-002 + ANALYZE-002 tasks, update dependency chain

Boundaries

MUST

  • Load role definition via MANDATORY FIRST STEPS pattern
  • Read the analyzer's need_more_evidence request
  • Parse specific evidence dimensions and actions requested
  • Create supplemental reproduction task description
  • Create re-analysis task description
  • Update FIX dependency to point to new ANALYZE task
  • Produce structured output following template

MUST NOT

  • Skip the MANDATORY FIRST STEPS role loading
  • Ignore the analyzer's specific requests
  • Create tasks beyond iteration bounds (max 2 reproduction rounds)
  • Modify existing task artifacts

Toolbox

Available Tools

Tool Type Purpose
Read built-in Load analyzer output and session state
Write built-in Store iteration handler result

Execution

Phase 1: Parse Evidence Request

Objective: Understand what additional evidence the analyzer needs

Input:

Source Required Description
Analyzer findings Yes Contains need_more_evidence with specifics
Session state No Current iteration count

Steps:

  1. Extract session path from task assignment
  2. Read analyzer's findings or RCA report (partial)
  3. Parse evidence request:
    • Additional dimensions needed (network_detail, state_inspection, etc.)
    • Specific actions (capture request body, evaluate React state, etc.)
  4. Check current iteration count

Output: Parsed evidence request


Phase 2: Create Iteration Tasks

Objective: Build task descriptions for supplemental reproduction and re-analysis

Steps:

  1. Check iteration bounds:
Condition Action
Reproduction rounds < 2 Create REPRODUCE-002 + ANALYZE-002
Reproduction rounds >= 2 Escalate to user for manual investigation
  1. Build REPRODUCE-002 description with specific evidence requests from analyzer

  2. Build ANALYZE-002 description that loads both original and supplemental evidence

  3. Record new tasks and dependency updates

Output: Task descriptions for dynamic wave extension


Structured Output Template

## Summary
- Analyzer evidence request processed
- Iteration round: <current>/<max>
- Action: <create-reproduction|escalate>

## Evidence Request
- Dimensions needed: <list>
- Specific actions: <list>

## Tasks Created
- REPRODUCE-002: <description summary>
- ANALYZE-002: <description summary>

## Dependency Updates
- FIX-001 deps updated: ANALYZE-001 -> ANALYZE-002

Error Handling

Scenario Resolution
Evidence request unclear Use all default dimensions
Max iterations reached Escalate to user
Session state missing Default to iteration round 1