version: "1.0.1" name: ae-sdd-discovery description: Discover high-level architectural requirements for change-set specs

SDD Discovery

Analyze high-level architectural requirements for implementing change-set specs to ensure proper alignment and identify potential concerns.

Required Skills

• spec-driven-development (state management, phase gates)
• research
• architecture-fit-check
• architecture-workshop

Inputs

[!IMPORTANT]

Resolve the change set by running ls changes/ | grep -v archive/. If exactly one directory exists, use it. Only prompt the user when multiple change sets are present.

Instructions

1. Load spec-driven-development skill and read current state from changes/<name>/state.toml. Apply state entry check per skill guidelines. If lane is not full or phase doesn't permit discovery, redirect the user.

1. Read proposal.md and any existing specs in changes/<name>/specs/.

1. Discovery answers how a change fits into or extends the existing architecture:

• Use research skill to understand current architectural patterns
• Use architecture-fit-check to assess alignment
• If concerns exist (technical debt, messy workarounds), enter Daedalus Mode:
• Explain concerns clearly
• Explore solutions (light-touch vs. architectural)
• Reach consensus with the user on approach

1. Document findings: Capture explorations, tradeoffs, and decisions in changes/<name>/thoughts/

1. Do not update phase status in this command. After documenting discovery artifacts, suggest ae-sdd-next <name> when the user wants to proceed.

Success Criteria

• Architecture fit assessed and documented
• Any concerns captured in thoughts/ directory
• Discovery artifacts complete and ready for ae-sdd-next
• User ready to proceed to tasks phase

Usage Examples

Do

• "This change slots cleanly into the existing Notification pattern."
• "Implementing this directly would create circular dependencies. Should we introduce an event bus instead?"

Don't

• Start planning implementation tasks or file-level changes.
• Guess at architectural alignment without researching the codebase.