Awesome-omni-skill ae-sdd-discovery
Discover high-level architectural requirements for change-set specs
install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/product/ae-sdd-discovery" ~/.claude/skills/diegosouzapw-awesome-omni-skill-ae-sdd-discovery && rm -rf "$T"
manifest:
skills/product/ae-sdd-discovery/SKILL.mdsource content
SDD Discovery
Analyze high-level architectural requirements for implementing change-set specs to ensure proper alignment and identify potential concerns.
Required Skills
(state management, phase gates)spec-driven-developmentresearcharchitecture-fit-checkarchitecture-workshop
Inputs
[!IMPORTANT] Resolve the change set by running
. If exactly one directory exists, use it. Only prompt the user when multiple change sets are present.ls changes/ | grep -v archive/
Instructions
-
Load
skill and read current state fromspec-driven-development
. Apply state entry check per skill guidelines. If lane is notchanges/<name>/state.toml
or phase doesn't permit discovery, redirect the user.full -
Read
and any existing specs inproposal.md
.changes/<name>/specs/ -
Discovery answers how a change fits into or extends the existing architecture:
- Use
skill to understand current architectural patternsresearch - Use
to assess alignmentarchitecture-fit-check - 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
- Use
-
Document findings: Capture explorations, tradeoffs, and decisions in
changes/<name>/thoughts/ -
Do not update phase status in this command. After documenting discovery artifacts, suggest
when the user wants to proceed.ae-sdd-next <name>
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.