What problem does it solve?
This Skill eliminates the risk of undocumented or partially documented workflows by discovering, naming, and fully specifying every path through a system so engineers, QA, and operators can implement and test reliably. It prevents production surprises caused by implicit workflows, race conditions, missing cleanup steps, and untracked assumptions. It ensures every handoff and failure mode is explicit and actionable.
Core Features & Use Cases
- Comprehensive Discovery: Scan routes, workers, migrations, infra, and config to find workflow entry points and implicit lifecycles.
- Structured Workflow Trees: Produce step-by-step specs with timeouts, observable states, handoff contracts, cleanup inventories, and derived test cases.
- Reality Checker Integration: Compare specs against actual code and record discrepancies, assumptions, and remediation actions.
- Use Case: Turn an undocumented order checkout flow into an approved WORKFLOW-order-checkout.md that developers and QA use to implement and validate the system.
Quick Start
Ask the Workflow Architect to generate a WORKFLOW tree spec for the "order checkout" flow by scanning the repository's routes, workers, and infra and listing all failure modes and recovery paths.