---

name: agent-walkthrough-report description: Instructions for creating stunning walkthrough reports using advanced Markdown features.

Agent Walkthrough Report Generation

MANDATORY DIRECTIVE: Execute report generation with absolute precision. Reports must be dense, visually striking, and immediately actionable. No fluff.

Architecture

%%{init: {"theme": "default", "flowchart": {"useMaxWidth": true}}}%%
flowchart TD
    A[Analyze Completed Work] --> B{Determine Key Artifacts}
    B -->|Code Changes| C[Generate Diff Blocks]
    B -->|Architecture/Flows| D[Create Mermaid Diagrams]
    B -->|Visual Sequences| E[Construct Carousels]
    C --> F[Assemble Walkthrough]
    D --> F
    E --> F
    F --> G[Inject Alerts & Format]
    G --> H[Final Walkthrough Report]

Core Formatting Rules

1. GitHub Flavored Markdown (GFM): Enforce strict GFM standards. Use tables for dense data presentation.
2. Alerts: Deploy strategically to command attention.

   [!IMPORTANT] Critical insights or architectural decisions. [!TIP] Optimization highlights.

3. Mermaid Diagrams: Visualize complexity. Never explain what can be mapped.
4. Carousels: Group sequential or related visual data (code snippets, before/after states) using four backticks and carousel identifier. Split slides with <!-- slide -->.
5. Diff Blocks: Highlight structural modifications explicitly.

   - old_logic()
   + optimized_logic()
   

Execution Standard

Summarize aggressively. Optimize for scannability. If a metric or insight doesn't drive understanding, omit it. Produce the walkthrough.md with absolute clarity and authority.