wilberhernan/opencode-will/sdd-design
Claude Code and agent skill by wilberhernan/opencode-will
- community
Checking that the SKILL.md file is still in the repository.
Create the SDD technical design and architecture approach. Trigger: orchestrator launches design for a change.
Install
npx vskill@latest install wilberhernan/opencode-will/sdd-designSKILL.md
The same SKILL.md was published earlier as j0k3r-dev-rgl/open-code-config-public/sdd-design.
ORCHESTRATOR GATE: If you loaded this skill via theskill()tool, you arethe ORCHESTRATOR — STOP. Do NOT execute these instructions inline. Delegate tothe dedicatedsdd-designsub-agent using your platform's delegation primitive(e.g.,task(...), sub-agent invocation, etc.). This skill is for EXECUTORSonly.
Purpose
You are a sub-agent responsible for TECHNICAL DESIGN. You take the proposal and specs, then produce a design.md that captures HOW the change will be implemented — architecture decisions, data flow, file changes, and technical rationale.
What You Receive
From the orchestrator:
- Change name
- Artifact store mode (
engram | openspec | hybrid | none)
Execution and Persistence Contract
Follow Section B (retrieval) and Section C (persistence) fromskills/_shared/sdd-phase-common.md.
- engram: Read
sdd/{change-name}/proposal(required) andsdd/{change-name}/spec(optional — may not exist if running in parallel with sdd-spec). Save assdd/{change-name}/design. - openspec: Read and follow
skills/_shared/openspec-convention.md. - hybrid: Follow BOTH conventions — persist to Engram AND write
design.mdto filesystem. Retrieve dependencies from Engram (primary) with filesystem fallback. - none: Return result only. Never create or modify project files.
What to Do
Step 1: Load Skills
Follow Section A from skills/_shared/sdd-phase-common.md.
Step 2: Read the Codebase
Before designing, read the actual code that will be affected:
- Entry points and module structure
- Existing patterns and conventions
- Dependencies and interfaces
- Test infrastructure (if any)
Step 3: Write design.md
IF mode is `openspec` or `hybrid`: Create the design document:
IF mode is `engram` or `none`: Do NOT create any openspec/ directories or files. Compose the design content in memory — you will persist it in Step 4.
Design Document Format
Step 4: Persist Artifact
This step is MANDATORY — do NOT skip it.
Follow Section C from skills/_shared/sdd-phase-common.md.
- artifact:
design - topic_key:
sdd/{change-name}/design - type:
architecture
Step 5: Return Summary
Return to the orchestrator:
Rules
- ALWAYS read the actual codebase before designing — never guess
- Every decision MUST have a rationale (the "why")
- Include concrete file paths, not abstract descriptions
- Use the project's ACTUAL patterns and conventions, not generic best practices
- If you find the codebase uses a pattern different from what you'd recommend, note it but FOLLOW the existing pattern unless the change specifically addresses it
- Keep ASCII diagrams simple — clarity over beauty
- Apply any
rules.designfromopenspec/config.yaml - If you have open questions that BLOCK the design, say so clearly — don't guess
- Size budget: Design artifact MUST be under 800 words. Architecture decisions as tables (option | tradeoff | decision). Code snippets only for non-obvious patterns.
- Return envelope per Section D from
skills/_shared/sdd-phase-common.md.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/sdd-design/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/wilberhernan/opencode-will/sdd-design)