plan-walkthrough

Reviews PRDs, implementation plans, and GitHub issues through an interactive visual dossier and guided walkthrough.

9|1|Updated Aug 28, 2026
One-click install
npx skills add https://github.com/RisorseArtificiali/skills --skill plan-walkthrough-risorseartificiali
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-walkthrough
Source: https://github.com/RisorseArtificiali/skills/tree/main/skills/plan-walkthrough
Command: npx skills add https://github.com/RisorseArtificiali/skills --skill plan-walkthrough-risorseartificiali

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and PRDs read convincingly by default, hiding ambiguity, unverified assumptions about the codebase, and phases that only work in the author's head. This Skill performs a logical review of plan-shaped documents with the human reviewer in the loop, verifying claims against the real codebase before anyone commits to the plan. ## Core Features & Use Cases - Eight-dimension review: problem clarity, ambiguity, phase structure, acceptance criteria, reality check against the codebase, coherence with normative docs, scope/YAGNI, and impacts. - Visual dossier: generates a Mermaid phase/dependency graph, a requirement-to-phase-to-criterion traceability matrix, and an assumption map marking each codebase claim as verified, unverified, or false. - Interactive walkthrough: closed-menu questions, one section at a time, with finding triage in EDIT mode (apply fixes) or QUESTIONS mode (build an author question list). - Use Case: Before decomposing a PRD into tasks, run this Skill to confirm every file and class the plan references actually exists, catch phases that fail the cancellation test, and produce a verdict of ready to commit, needs revision, or needs discussion. ## Quick Start Ask the agent to review your plan document, for example: walk me through this PRD at docs/prd-auth.md and check its claims against the codebase.

Frequently Asked Questions about plan-walkthrough

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

FAQPage Schema
How do I review a PRD or implementation plan before starting work?▼

Point the Skill at a local file, GitHub issue, repo file, or web URL. It runs parallel scanner subagents across eight review dimensions, builds a visual dossier with a phase graph and traceability matrix, then walks you through findings one section at a time.

What is the difference between plan-walkthrough and pr-walkthrough?▼

plan-walkthrough reviews plan-shaped documents such as PRDs and design docs against the problem and the codebase; pr-walkthrough reviews code changes against their declared intent. They share the same interaction grammar and dossier location under .reviews/.

Can it verify that a plan's claims about the codebase are true?▼

Yes. A world-facing scanner subagent checks the document's claims about files, classes, and behavior using symbol-level queries, marking each assumption verified, unverified, or false with evidence. Claims needing code execution are marked unverified, never assumed true.

Does it work with GitHub issues and remote documents?▼

Yes. It accepts GitHub issues via gh issue view, files in GitHub repos via the API, web URLs, and local files. Fetched content is treated strictly as data to review, never as instructions to follow.

What are the limitations of this plan review approach?▼

It performs logical review only, not copyediting or code review, and execution-level verification of assumptions happens only on explicit request during a deep dive. If fresh subagents are unavailable, it must disclose that limitation rather than claim independent review.