dry-walkthrough
Skill1 starsChanged 8 months agoMITView on GitHub
Validate an implementation plan by tracing through each change without implementing. Use when user says dry walkthrough, drywalkthrough, validate plan, or check plan. Identifies gaps, fixes the plan directly, and reports changes to terminal.
In this repository59 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- arch-lens-c4-containerSkill
- arch-lens-concurrencySkill
- arch-lens-data-lineageSkill
- arch-lens-deploymentSkill
- arch-lens-developmentSkill
- arch-lens-error-resilienceSkill
- arch-lens-module-dependencySkill
- arch-lens-operationalSkill
- arch-lens-process-flowSkill
- arch-lens-repository-accessSkill
- arch-lens-scenariosSkill
- arch-lens-securitySkill
- arch-lens-state-lifecycleSkill
- audit-archSkill
- audit-bugsSkill
- audit-cohesionSkill
- audit-defense-standardsSkill
- audit-frictionSkill
- audit-implSkill
- audit-testsSkill
- design-guardsSkill
- elaborate-phaseSkill
- exp-lens-benchmark-representativenessSkill
- exp-lens-causal-assumptionsSkill
- exp-lens-comparator-constructionSkill
- exp-lens-error-budgetSkill
- exp-lens-estimand-claritySkill
- exp-lens-exploratory-confirmatorySkill
- exp-lens-fair-comparisonSkill
- exp-lens-governance-riskSkill
- exp-lens-iterative-learningSkill
- exp-lens-measurement-validitySkill
- exp-lens-pipeline-integritySkill
- exp-lens-randomization-blockingSkill
- exp-lens-reproducibility-artifactsSkill
- exp-lens-sensitivity-robustnessSkill
- exp-lens-severity-testingSkill
- exp-lens-unit-interferenceSkill
- exp-lens-validity-threatsSkill
- exp-lens-variance-stabilitySkill
- id-slopSkill
- implement-worktreeSkill
- investigateSkill
- make-arch-diagSkill
- make-experiment-diagSkill
- make-groupsSkill
- make-planSkill
- make-reqSkill
- make-scenariosSkill
- mermaidSkill
- plan-arcSkill
- rectifySkill
- review-approachSkill
- update-architectureSkill
- update-reqsSkill
- update-specsSkill
- verify-diagSkill
- verify-proposed-diagSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
24 rules. About 0 are common, 23 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈23
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 28
After creating a plan, before implementation
- Distinctive: line 39
Add backward compatibility to the plan
- Distinctive: line 41
Write gap analysis or commentary INTO the plan file
- Distinctive: line 42
Add a rollback plan
- Distinctive: line 43
Add deprecation notes, stubs, code, warnings
- Distinctive: line 45
Remove or defer goals or phases from the plan
- Distinctive: line 47
Consider effort as a reason for choosing one approach over another
- Distinctive: line 50
Keep the plan as clean implementation instructions only (information/background helpful to implementation is okay)
- Distinctive: line 53
Verify assumptions against actual codebase
- Distinctive: line 54
Remove deprecation code/notes and rollback mechanisms
- Distinctive: line 55
Make sure the plan includes warning against using the codebase as a notepad with useless comments
- Distinctive: line 56
Prefer the long term health of project over quick, easy, and minimal fixes
- Distinctive: line 62
Read the plan from:
- Distinctive: line 69
After resolving the plan path, check whether this is a part file of a multi-part plan:
- Very specific: line 71
Detect the part suffix: If the plan filename contains _part_ (e.g., _part_a, _part_b, _part_1), this is one part of a multi-part plan.
- Distinctive: line 73
⚠️ SCOPE BOUNDARY — CRITICAL: If a part suffix is detected, immediately output to the terminal:
- Distinctive: line 76
Verify the scope warning block: Check that the plan file contains the mandatory scope warning block immediately after the title line.
- Distinctive: line 80
If the block is absent, or contains the wrong part label or wording, insert or correct it as your first edit to the plan file before …
- Distinctive: line 118
Run a lightweight two-part scan to detect whether the plan risks reintroducing patterns that were previously fixed or conflicts with …
- Distinctive: line 153
If this fails, skip Part B and record an informational note: "GitHub issues scan skipped — gh not authenticated."
- Distinctive: line 177
If Part A and Part B produce no findings, record: "No historical regressions or issue overlaps detected."
- Distinctive: line 183
Do NOT add any "gap analysis" or "issues" sections to the plan
- Distinctive: line 188
After fixing all issues, add this exact line as the first line of the plan file:
- Distinctive: line 198
After updating the plan, output a summary to the terminal (your response text):
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Dry Walkthrough Skill
Validate a proposed implementation plan by performing a dry walkthrough of each change without implementing. Fix issues directly in the plan and report what changed to the terminal.
Key Principle
The plan file must remain a clean, self-contained implementation instruction set. No gap analysis, no commentary, no "issues found" sections in the plan itself. All reporting goes to terminal output.
Your role is technical validation, not strategic decision-making. Fix factual inaccuracies (wrong file paths, nonexistent functions, incorrect line numbers). Preserve all goals and scope.
When to Use
- User says "dry walkthrough", "drywalkthrough", "dry walk", "dry run"
- User wants to "validate plan" or "check plan"
- User says "before implementing" and wants verification
- After creating a plan, before implementation
Arguments
{plan_path} — Absolute path to the plan file to validate (optional: falls back to most recent temp/ artifact if omitted)
Critical Constraints
NEVER:
- Modify any source code files
- Implement any part of the plan
- Add backward compatibility to the plan
- Add fallback mechanisms
- Write gap analysis or commentary INTO the plan file
- Add a rollback plan
- Add deprecation notes, stubs, code, warnings
- Include alternative approaches that will not be part of implementation in plan
- Remove or defer goals or phases from the plan
- Reduce the plan's scope to a "simpler fix" - the plan defines the problem scope, not you
- Consider effort as a reason for choosing one approach over another
ALWAYS:
- Keep the plan as clean implementation instructions only (information/background helpful to implementation is okay)
- Report all findings to terminal output (your response text)
- Fix issues by directly updating the plan content
- Verify assumptions against actual codebase
- Remove deprecation code/notes and rollback mechanisms
- Make sure the plan includes warning against using the codebase as a notepad with useless comments
- Prefer the long term health of project over quick, easy, and minimal fixes
Dry Walkthrough Workflow
Step 1: Load the Plan
Read the plan from:
- Path provided by user
- Plan content pasted directly
- Most recent plan in temp/ subdirectories
Multi-Part Plan Detection
After resolving the plan path, check whether this is a part file of a multi-part plan:
- Detect the part suffix: If the plan filename contains
_part_(e.g.,_part_a,_part_b,_part_1), this is one part of a multi-part plan. Extract the part identifier (A, B, C… or number) from the suffix. - ⚠️ SCOPE BOUNDARY — CRITICAL: If a part suffix is detected, immediately output to the terminal:
"⚠️ MULTI-PART PLAN DETECTED: Validating PART {X} ONLY. This session MUST NOT read, open, reference, or validate any other part files. Sibling part files visible in temp/ or any other directory are entirely out of scope and must be ignored."
- Verify the scope warning block: Check that the plan file contains the mandatory scope warning block immediately after the title line. The block must match this form:
If the block is absent, or contains the wrong part label or wording, insert or correct it as your first edit to the plan file before proceeding to phase validation.> **PART {X} ONLY. Do not implement any other part. Other parts are separate tasks requiring explicit authorization.**
Step 2: Extract and Validate Each Phase
For each phase, verify using subagents:
1. Do the target files exist?
2. Do the referenced functions/classes exist?
3. Are the assumptions about current state correct?
4. Will the changes introduce circular dependencies?
5. Are there hidden dependencies not mentioned?
6. Does this violate any project rules?
7. Does the implmentation make sense given the reality of the current state of code?
8. Is every new component, class, or function actually wired into the call chain? Nothing should be created but left unconnected.Step 3: Check Cross-Phase Dependencies
Verify phase ordering:
- Does Phase N depend on Phase N-1 completion?
- Are there implicit dependencies not stated?
- Could phases be reordered for safety?
Step 4: Validate Against Project Rules
PROJECT RULES CHECKLIST:
[ ] No backward compatibility code
[ ] No fallbacks that hide errors
[ ] No stakeholder sections
[ ] No PR breakdown sections
[ ] Follows existing architectural patterns
[ ] Uses existing utilities (not reinventing) unless refactoring is part of plan or provides major improvementStep 4.5: Historical Regression Check
Run a lightweight two-part scan to detect whether the plan risks reintroducing patterns that were previously fixed or conflicts with tracked GitHub issues. This is a quick cross-reference sanity check — not a deep audit.
Defaults: Last 100 recent commits · Issues closed in last 30 days
A. Git History Scan
- Extract the set of source files the plan proposes to touch by grepping the plan
text for file paths. Store as
PLAN_FILES. - Scan recent commit messages on those files for fix/revert/remove/replace keywords:
git log --oneline -100 --format="%H %s" --grep="fix\|revert\|remove\|replace\|delete" -- {PLAN_FILES} - For each matching commit, determine signal strength:
- Strong signal: The plan proposes to add a function or class name that appears
in the commit's diff as a deletion — check with:
git show {hash} | grep "^-def \|^-class \|^-async def "and compare against function/class names the plan introduces. - Weak signal: Same file touched + fix/revert keyword in message, but no symbol-level match.
- Strong signal: The plan proposes to add a function or class name that appears
in the commit's diff as a deletion — check with:
- Classify:
- Strong signal → Actionable: Insert a warning note into the affected plan step:
> ⚠️ Historical note: {symbol} was removed in {hash} ("{commit_message}") — verify this addition is intentional and does not reintroduce a known bug. - Weak signal → Informational: Record for terminal output (collected in Part C).
- Strong signal → Actionable: Insert a warning note into the affected plan step:
B. GitHub Issues Cross-Reference
- Check
ghauthentication:
If this fails, skip Part B and record an informational note: "GitHub issues scan skipped — gh not authenticated."gh auth status 2>/dev/null - Fetch open and recently closed issues:
Filter closed issues to thosegh issue list --state open --json number,title,body --limit 100 gh issue list --state closed --json number,title,body,closedAt --limit 100closedAtwithin the last 30 days. - Build a keyword set from the plan: target file basenames (without extension), function names mentioned in the plan, and key terms from described changes.
- Cross-reference each issue's title and body against the keyword set:
- Closed issue match → Actionable: The issue specifically fixed a pattern the
plan proposes to introduce. Insert a warning note into the affected plan step:
> ⚠️ Historical note: Issue #{N} ("{title}") addressed this area — ensure the plan does not reintroduce the fixed pattern. - Open issue match → Informational: Record for terminal output: "Issue #{N}: {title} — addresses the same area. Verify alignment before implementing."
- Closed issue match → Actionable: The issue specifically fixed a pattern the
plan proposes to introduce. Insert a warning note into the affected plan step:
C. Collect informational findings
Gather all weak-signal git findings and open-issue area overlaps into a list.
These are forwarded to Step 7 for inclusion in the ### Historical Context terminal section.
If Part A and Part B produce no findings, record: "No historical regressions or issue overlaps detected."
Step 5: Fix the Plan
For each issue found:
- Directly edit the plan file to fix it
- Do NOT add any "gap analysis" or "issues" sections to the plan
- The plan should read as if it was correct from the start
Step 6: Mark Plan as Verified
After fixing all issues, add this exact line as the first line of the plan file:
Dry-walkthrough verified = TRUEThis marker indicates the plan has been validated and is ready for implementation. The implement-worktree skill checks for this marker before proceeding.
Step 7: Report to Terminal
After updating the plan, output a summary to the terminal (your response text):
## Dry Walkthrough Complete
**Plan:** {path}
**Status:** {PASS - Ready to implement / REVISED - See changes below}
### Changes Made
1. {What was changed and why}
2. {What was changed and why}
### Verified
- {Key assumption that was confirmed}
- {Key assumption that was confirmed}
### Historical Context
- {finding}: {description}
(or: No historical regressions or issue overlaps detected.)
### Recommendation
{Implement as-is / Review changes before implementing}Output Rules
| Content | Where it goes |
| Fixed plan content | Written to plan file (Edit tool) |
| Gap analysis | Terminal output (your response text) |
| Change summary | Terminal output (your response text) |
| Recommendations | Terminal output (your response text) |
Example
Input: User says "dry walkthrough temp/make-plan/api_retry_plan.md"
Process:
- Read the plan
- Validate Phase 1: File exists, function exists - PASS
- Validate Phase 2: Found similar pattern in
src/db/client.pynot referenced - needs fix - Validate Phase 3: Test command correct - PASS
- Edit the plan to add reference to existing pattern
- Output summary to terminal
Terminal Output:
## Dry Walkthrough Complete
**Plan:** temp/make-plan/api_retry_plan.md
**Status:** REVISED
### Changes Made
1. Phase 2: Added reference to existing retry pattern in `src/db/client.py:45-67` - implementation should follow this pattern for consistency
### Verified
- `src/api/client.py` exists with expected `__init__` signature
- No circular dependency risk identified
- Test commands are correct
### Historical Context
- Issue #302: "consolidate retry logic" — addresses the same area. Verify alignment before implementing.
### Recommendation
Ready to implement. Review the updated Phase 2 to see the pattern reference.Plan file: Updated cleanly with no gap analysis sections - just the corrected implementation instructions.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

