walkthrough-generate

name	walkthrough-generate
description	Generate implementation walkthrough for human review after run completion. Documents decisions, changes, and verification steps.
version	1.0.0

Generate implementation walkthrough for human review after run completion. - Run completed successfully - Invoked by run-execute skill

<degrees_of_freedom> LOW — Follow walkthrough structure precisely. Be thorough but concise. </degrees_of_freedom>

ALWAYS generate walkthrough after run completion Document DECISIONS, not just changes Include verification steps — how to test this works Track DEVIATIONS from plan — compare to original work item List ALL new dependencies added during implementation Capture developer notes — gotchas save future debugging time Read run log from .specs-fire/runs/{run-id}/run.md Read work item plan from .specs-fire/intents/{intent}/work-items/{work-item}/ Collect: Work item details (id, title, intent) Files created during implementation Files modified during implementation Decisions made during execution Tests added and coverage Dependencies added (new packages in package.json, requirements.txt, etc.) Deviations from the original work item plan For each file created/modified: Identify purpose of the file Summarize key changes Note patterns or approaches used Document structure overview: How the pieces fit together architecturally Data flow or component relationships Keep high-level, NO CODE Identify architecture pattern (if multi-component): Pattern used (Repository, Service Layer, MVC, Clean Architecture, etc.) Layer structure diagram (ASCII) if applicable Document domain model (if entities/models created): Entities with properties and business rules Value objects with constraints Extract implementation highlights: Main flow/algorithm implemented Integration points with existing code Document security considerations (if applicable): Authentication/authorization approach Input validation strategy Data protection measures Format as table: Concern | Approach Document performance considerations (if applicable): Optimization strategies used Caching, indexing, or query optimization Scalability approach Format as table: Requirement | Implementation Document deviations from plan: Compare implementation to original work item plan Note any changes and explain WHY they were made If no deviations, state "None" Capture developer notes: Gotchas or non-obvious behaviors Tips for future developers Context that would save debugging time Generate how-to-verify section: Commands to run the feature Expected behavior/output Manual test scenarios Evaluate implementation completeness: All acceptance criteria met? Tests passing? No critical issues remaining? Documentation updated (if applicable)? Developer notes captured? Generate checklist with [x] for met, [ ] for unmet Generate walkthrough using template: templates/walkthrough.md.hbs Include all sections (conditional sections only if data exists): Architecture — only if multi-component with clear pattern Domain Model — only if entities/value objects created Security Considerations — only if security-relevant changes Performance Considerations — only if performance-relevant changes Save to: .specs-fire/runs/{run-id}/walkthrough.md Walkthrough generated: .specs-fire/runs/{run-id}/walkthrough.md