Structured Output

## Table of Contents

- [When to Use](#when-to-use)
- [Activation Patterns](#activation-patterns)
- [Required TodoWrite Items](#required-todowrite-items)
- [Step 1: Select Template (`structured-output:template-selected`)](#step-1:-select-template-(structured-output:template-selected))
- [Step 2: Format Findings (`structured-output:findings-formatted`)](#step-2:-format-findings-(structured-output:findings-formatted))
- [Step 3: Assign Actions (`structured-output:actions-assigned`)](#step-3:-assign-actions-(structured-output:actions-assigned))
- [Step 4: Attach Appendix (`structured-output:appendix-attached`)](#step-4:-attach-appendix-(structured-output:appendix-attached))
- [Output Quality Checklist](#output-quality-checklist)
- [Exit Criteria](#exit-criteria)


# Structured Output

## When To Use
- When finalizing any review or analysis.
- To format findings in a consistent way that names specific next steps.
- Before presenting results to stakeholders or committing them to documentation.

## When NOT To Use

- Capturing evidence during analysis - use proof-of-work
- Reviewing changes - use diff-analysis or review-core first

## Activation Patterns
**Trigger Keywords**: format, structure, deliverable, report, organize, present, consistent
**Contextual Cues**:
- "format this as a report" or "structure the output"
- "create a deliverable" or "present these findings"
- "organize this consistently" or "standardize the format"
- "make this actionable" or "prepare for stakeholders"

**Auto-Load When**: Finalizing any analysis deliverable or when consistent formatting is requested.

## Required TodoWrite Items
1. `structured-output:template-selected`
2. `structured-output:findings-formatted`
3. `structured-output:actions-assigned`
4. `structured-output:appendix-attached`

Mark each item complete as you finish the corresponding step.

## Step 1: Select Template (`structured-output:template-selected`)
- Choose output format based on deliverable type:
  - **Review Report**: Summary, Findings, Recommendations, Evidence.
  - **PR Description**: Summary, Changes, Test Plan, Notes.
  - **Release Notes**: Highlights, Breaking Changes, Fixes, Credits.
  - **Incident Report**: Timeline, Impact, Root Cause, Remediation.
- Confirm audience and required detail level.

## Step 2: Format Findings (`structured-output:findings-formatted`)
- Use consistent finding structure:
  ```markdown
  ### [SEVERITY] Finding Title
  **Location**: file.rs:123
  **Anchor**: `verbatim source text copied from line 123`
  **Category**: Security | Performance | Correctness | Style
  **Description**: Brief explanation of the issue.
  **Evidence**: [E1, E2] - Reference to evidence log.
  **Recommendation**: Specific remediation steps.
  ```
  **Verification:** Run the command with `--help` flag to verify availability.
- Severity levels: CRITICAL, HIGH, MEDIUM, LOW, INFO.
- Order findings by severity, then by file location.
- **Anchor is mandatory and grounds the finding.** Copy the exact
  source text at `Location` (not a paraphrase). It is what a second
  pass re-reads to confirm the finding is real. A finding whose anchor
  does not appear at its cited line is treated as a hallucination and
  dropped. The check is mechanical: `imbue:review-core` Step 6 runs
  `plugins/imbue/scripts/citation_verifier.py` over the findings.

## Step 3: Assign Actions (`structured-output:actions-assigned`)
- Convert findings to action items with assignee and priority:
  ```markdown
  ## Action