shamt-discovery

Epic discovery is a structured research phase that surfaces questions, risks, and scope before feature planning. You need epic discovery to reduce rework later by validating the problem space and documenting findings in DISCOVERY.md.

Automate epic discovery by initiating the S1 discovery flow to read architecture docs and brainstorm across six categories. The system runs iterative validation loops to produce a complete DISCOVERY.md with recommended approach and feature breakdown.

The validation loop works by running iterative discovery rounds until a primary clean round and sub-agent confirmations are achieved. This ensures quality control and validates findings before moving to feature breakdown.

You can use this structured discovery workflow for any epic planning scale because the process is mandatory for every epic. It adapts to your architecture docs to ensure prerequisites and exit criteria are met regardless of project size.

The generated DISCOVERY.md document includes an executive summary, technical analysis, solution options, and a recommended approach. It also contains a feature breakdown confirmed through a user approval workflow.

You should not use an automated discovery phase when you lack existing architecture docs for the system to read, as this workflow relies on parsing those documents to brainstorm across its six categories and validate the problem space.