sw-design-solution
Turn a PRD (specs/NNNN-slug.md) into a technical spec at specs/NNNN-slug-spec.md. Applies TDD — every acceptance criterion gets an implementation plan and e2e coverage, with Shopware toolchain (shopware-cli/PHPStan/ESLint/Stylelint) conventions baked into decisions up front. Runs a clarification loop for the gaps that change the implementation plan, and on the user's say-so extracts project-wide architecture/stack decisions into ADR files (specs/NNNN-slug-adr-<topic>.md) that gate readiness while proposed. Pre-checks vendor/ and the KB before it starts. Use when asked to write, draft, refine, or continue a tech spec / implementation plan. Never edits the source PRD or answers business/requirements questions — that's sw-design-requirements.
Pinned to revision 2aeb8b726263, so it is the text this page describes rather than whatever the author pushed since.
Pre-approved tools experimental
Experimental field. Support varies between clients, so this list is what the author declared, not what your client will enforce.
- Read
- Write
- Edit
- Glob
- Grep
- AskUserQuestion
- Agent
- Skill
- Bash(ls *)
- Bash(npx -y @execuro-sw-ecosystem/sw-specs-editor@latest *)
- WebSearch
- WebFetch
- mcp__ShopwareDevKnowledgeBase__list_docs
- mcp__ShopwareDevKnowledgeBase__grep_docs
- mcp__ShopwareDevKnowledgeBase__read_doc
- mcp__ShopwareDevKnowledgeBase__kb_status
Files
- skills/sw-design-solution/SKILL.md
- skills/sw-design-solution/reference/adr-flow.md
- skills/sw-design-solution/reference/adr-template.md
- skills/sw-design-solution/reference/clarification-loop.md
- skills/sw-design-solution/reference/draft-and-spawn.md
- skills/sw-design-solution/reference/editor-mode.md
- skills/sw-design-solution/reference/pre-check-and-target.md
- skills/sw-design-solution/reference/readiness-and-report.md
- skills/sw-design-solution/reference/research-and-evidence.md
- skills/sw-design-solution/reference/tech-spec-template.md
- skills/sw-design-solution/reference/toolchain-conformance.md
Every link opens the file at its source, pinned to the revision this page describes.