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
- GitHub Flavored Markdown (GFM): Enforce strict GFM standards. Use tables for dense data presentation.
- Alerts: Deploy strategically to command attention.
[!IMPORTANT] Critical insights or architectural decisions. [!TIP] Optimization highlights.
- Mermaid Diagrams: Visualize complexity. Never explain what can be mapped.
- Carousels: Group sequential or related visual data (code snippets, before/after states) using four backticks and
carouselidentifier. Split slides with<!-- slide -->. - 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.