What problem does it solve? Systems break in production because workflows are never fully specified — implicit flows live only in code, failure branches go undocumented, and handoffs between services lack defined contracts. This Skill discovers every workflow in a codebase and produces build-ready specs that engineers can implement against and QA can test against. ## Core Features & Use Cases - Workflow Discovery & Registry: Scans routes, workers, migrations, IaC configs, and cron jobs to find undocumented workflows, then maintains a four-view registry (by workflow, component, user journey, and state). - Build-Ready Workflow Tree Specs: Produces structured specs covering happy paths, validation failures, timeouts, partial failures, concurrent conflicts, observable states, handoff contracts, and cleanup inventories. - Test Case Derivation: Converts every branch in the workflow tree into a test case so QA can generate complete automated test suites without clarifying questions. - Use Case: Before building a checkout feature, use this Skill to map the full order workflow — including payment timeout recovery, partial-failure rollback, and what the customer and operator see at each state — so implementation and testing proceed without guesswork. ## Quick Start Ask the agent to audit this repository and produce a workflow registry plus a full workflow tree spec for the user signup flow.
