Codebase Design
Felles vokabular for design av dype moduler: grensesnitt, skjøter, adaptere, testbarhet
Bestått
Hva den gjør
En vokabular- og prinsippferdighet for design av dype moduler – mye atferd bak et lite grensesnitt, plassert ved en ren skjøt og testet gjennom det grensesnittet. Den utløses når brukeren ønsker å designe eller forbedre et moduls grensesnitt, bestemme hvor en skjøt skal være, klassifisere avhengigheter for testing, eller gjøre kode mer testbar. To støttefiler legger til en fordypende arbeidsflyt (avhengighetskategorier, replace-don't-layer testing) og en parallell underagent 'design it twice'-prosess.
Testrapport
Hentet alle tre filer rå (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md alle HTTP 200); frontmatter parses med name+description, ingen skript, ingen sikkerhetsbrudd. Kjørte en reell designoppgave i kontekst – "design grensesnittet for en rate-limiter som beskytter et tredjeparts API" – og produserte en baseline-artefakt og en ferdighetsstyrt artefakt. Konkret forskjell: baseline eksponerte en 4-metoders Redis-koblet klasse (tryAcquire/getRemaining/reset/setLimit); ferdighetsversjonen reduserte kalloverflaten til ett guard(key, action) inngangspunkt, klassifiserte Redis som kategori-2 lokalt-erstattbar vs SMS API som kategori-4 ekte-ekstern, og anvendte "to adaptere = ekte skjøt" for å beholde lagringsporten mens klokken ble skjult som en intern skjøt. Ferdighetsteksten omformet designet målbart i stedet for bare å bli sitert tilbake.
Testet på: 2026-07-21 · Claude Code 2.x (agent harness)
Installer
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.
Kommandoer og eksempelprompter
/codebase-designFelles vokabular for design av dype moduler: grensesnitt, skjøter, adaptere, testbarhet
Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):
Help me design a deeper interface for this moduleFind deepening opportunities in this classDecide where the seam should go in this code