visual-implementation-recap

Render a visual HTML recap of milestone changes from git diff, plan, and audit report data.

8|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/ddobrin/plan-skills --skill visual-implementation-recap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-implementation-recap
Source: https://github.com/ddobrin/plan-skills/tree/main/plugins/plan/skills/visual-implementation-recap
Command: npx skills add https://github.com/ddobrin/plan-skills --skill visual-implementation-recap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill transforms a milestone's actual implementation diff, completed plan, and audit report into a trustworthy visual recap, reducing the effort required for human commit-gate review.

Core Features & Use Cases

  • Grounded Change Summary: Presents the real outcome, headline metrics, completed tasks, changed-file tree, and annotated diffs without inventing implementation details.
  • Evidence-Based Review: Reflects audit verdicts, verification evidence, findings, tests, risks, and deferred follow-ups in a single browsable HTML document.
  • Self-Contained Rendering: Produces a file-based visual recap with optional architecture, API/schema, UI, and notes surfaces while preserving Mermaid source fallbacks and masking secrets.
  • Use Case: After an engineer completes a milestone and an auditor produces a green audit, use this Skill to generate visual-recap.html for reviewing the full change before committing.

Quick Start

Use the visual-implementation-recap skill after the audit to render the current milestone's grounded implementation recap at plans/active_milestones/{moniker}/visual-recap.html.

Frequently Asked Questions about visual-implementation-recap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an HTML report from a git diff for commit-gate review?

You can generate an HTML report from a git diff by rendering the milestone's implemented changes, completed plan, and audit report into a self-contained visual-recap.html file for commit-gate review.

What is a visual implementation recap and when do I need one?

A visual implementation recap is a trustworthy HTML document summarizing a milestone's actual git diff, audit verdicts, and changed-file tree. You need one to reduce human effort during commit-gate reviews of feature implementations, refactors, or tests.

How do I visualize code changes and audit findings in a single browsable document?

You can visualize code changes and audit findings in a single browsable document by rendering the milestone's completed plan, audit verdicts, and annotated git diffs into a self-contained HTML report with optional architecture and UI surfaces.

Does the visual recap process mask secrets and avoid committing changes to version control?

Yes, the visual recap process requires read-only grounding from version-control and milestone artifacts, applies secret redaction, and outputs a self-contained HTML file without committing changes to the repository.

Can I use this recap tool for architecture changes, contract changes, and user-facing UI changes?

Yes, you can use this recap tool for commit-gate reviews of architecture changes, contract changes, and user-facing UI changes. It renders optional architecture, API/schema, and UI surfaces while preserving Mermaid source fallbacks.