Codebase Design
Gedeelde vocabulaire voor het ontwerpen van diepe modules: interfaces, scheidingen, adapters, testbaarheid
Getest · Werkt
Wat het doet
Een vocabulaire- en principes-skill voor het ontwerpen van diepe modules — veel gedrag achter een kleine interface, geplaatst op een schone scheiding en getest via die interface. Het wordt geactiveerd wanneer de gebruiker de interface van een module wil ontwerpen of verbeteren, wil beslissen waar een scheiding komt, afhankelijkheden wil classificeren voor testen, of code testbaarder wil maken. Twee ondersteunende bestanden voegen een verdiepende workflow (afhankelijkheidscategorieën, replace-don't-layer testen) en een parallel sub-agent "design it twice" proces toe.
Testrapport
Alle drie de bestanden raw opgehaald (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md allemaal HTTP 200); frontmatter parset met name+description, geen scripts, geen beveiligingsrisico's. Een echte ontwerptaak in context uitgevoerd — "design the interface for a rate-limiter guarding a third-party API" — wat een baseline-artefact en een skill-gevolgd artefact opleverde. Concreet verschil: baseline exposeerde een 4-methoden Redis-gekoppelde klasse (tryAcquire/getRemaining/reset/setLimit); de skill-versie reduceerde het aanroeperoppervlak tot één guard(key, action) entry point, classificeerde Redis als category-2 local-substitutable versus de SMS API als category-4 true-external, en paste "two adapters = real seam" toe om de store-poort te behouden terwijl de klok als interne scheiding werd verborgen. De skill-body heeft het ontwerp meetbaar hervormd in plaats van alleen te worden geciteerd.
Getest op: 2026-07-21 · Claude Code 2.x (agent harness)
Installatie
git clone --depth 1 https://github.com/mxyhi/ok-skills.git /tmp/codebase-design-src mkdir -p ~/.claude/skills cp -R /tmp/codebase-design-src/codebase-design ~/.claude/skills/codebase-design # Pure markdown skill: SKILL.md + DEEPENING.md + DESIGN-IT-TWICE.md. No deps, scripts, or API keys. # DESIGN-IT-TWICE.md references a project-local CONTEXT.md (your own domain vocab) which is not shipped and is optional.
Commando's en voorbeeldprompts
/codebase-designGedeelde vocabulaire voor het ontwerpen van diepe modules: interfaces, scheidingen, adapters, testbaarheid
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Help me design a deeper interface for this moduleFind deepening opportunities in this classDecide where the seam should go in this code