MVPavan/via / .claude/skills/codebase-design
codebase-design
VerifiedUse for substantive module-interface, encapsulation, or testability decisions. Skip ordinary code explanations and cosmetic refactors.
| File | Kind | Size |
|---|---|---|
| DEEPENING.md | markdown | 1.1 KB |
| DESIGN-IT-TWICE.md | markdown | 720 B |
| SKILL.md | skill md | 2.0 KB |
| agents/openai.yaml | config | 42 B |
DEEPENING.md
View on GitHub# Deepening by dependency shape
Use the codebase-design definitions when deciding whether a module can hide
complexity without moving it into callers. Dependency categories suggest options,
not automatic permission to merge modules.
| Dependency | Candidate test/design strategy |
|---|---|
| In-process computation/state | Test meaningful behavior directly; preserve useful ownership boundaries |
| Locally substitutable I/O | Real lightweight instance or faithful fake, with integration coverage for differences |
| Remote owned service | Explicit transport contract; inject a suitable adapter when it isolates a present concern |
| External service | Test the owned boundary with safe fixtures/fakes; verify important provider assumptions separately |
Encapsulation or a present testing need can justify an interface with one adapter.
Internal seams need not become public API. Preserve tests that catch meaningful
failures; remove old tests only when their behavior is covered or intentionally
retired. Interface tests and focused internal algorithm tests can complement each
other. A changed test needs inspection, not automatic deletion or rejection.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |