SDD Discovery

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.

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

3. 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

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

5. 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.