Walkthrough the user experience of a problem/feature before or after spec generation
Interactively explore and document real user experiences with existing tools before building. Use this to validate specs against actual pain points rather than assumptions.
/plugin marketplace add JesseHenson/claude_code_apex_marketplace/plugin install mcp-opportunity-pipeline@claude-code-apex-marketplaceInteractively explore and document the actual user experience of a problem or feature. This helps validate specs against reality.
Before building, you should understand:
--spec: Spec name to walkthrough (e.g., airtable-advanced-mcp)--feature: Specific feature to explore (e.g., linked-records)--tool: External tool to set up and test (e.g., smithery-airtable-mcp)Guide user through setting up the existing tool/MCP:
Walk through the specific feature:
Reproduce the actual problem:
Document the gap for the spec:
Saves to outputs/{name}/walkthrough.md with:
Also updates the spec's walkthrough section in outputs/{name}/spec.md.
/mcp-opportunity-pipeline:walkthrough --spec airtable-advanced-mcp --feature linked-records
/mcp-opportunity-pipeline:walkthrough --tool smithery-airtable-mcp
/mcp-opportunity-pipeline:walkthrough --spec notion-database-sync-mcp
When run, the agent will:
Ask clarifying questions:
Guide setup:
Document findings:
Specs based on assumptions fail. Specs based on reproduced pain points succeed.
Before: "Users complain about linked records"
After: "When you query a Projects table with a linked Clients field, the MCP returns ['rec123', 'rec456'] instead of the actual client names. You have to make N additional API calls to resolve them."