maicongambini/omp-harness-guide/codebase-design

Claude Code and agent skill by maicongambini/omp-harness-guide

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Designs module boundaries and test seams to minimize coupling. Use when refactoring internal module contracts or boundaries. Do NOT use for system-wide service topology (use backend-architect).

Install

npx vskill@latest install maicongambini/omp-harness-guide/codebase-design

SKILL.md

The same SKILL.md was published earlier as maicongambini/omp-harness-guide/codebase-design.

Codebase Design

Design deep modules: substantial behavior behind a small, stable interface.

Vocabulary

  • Module: a unit with an interface and implementation.
  • Interface: every fact callers need to use the module correctly, including invariants and failure modes.
  • Seam: where behavior can change without editing the caller.
  • Adapter: a concrete implementation at a seam.
  • Depth: leverage provided by behavior hidden behind a small interface.
  • Locality: changes, knowledge, and verification concentrated in one place.

Method

  1. Read CONTEXT.md and relevant ADRs if they exist.
  2. Identify the caller-facing behavior and the highest useful test seam.
  3. Apply the deletion test: if deleting the module only moves complexity to callers, it earns its place.
  4. Prefer one real seam over hypothetical abstractions. One adapter is usually speculation; two real adapters justify the seam.
  5. Propose the smallest interface that hides the complexity and lets callers and tests cross the same seam.
  6. Route significant changes through PREVC before editing.

Avoid interfaces that merely forward calls or expose implementation structure.

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

Popularity

7-day trend score
5

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/maicongambini/omp-harness-guide/codebase-design/badge)](https://verified-skill.com/skills/maicongambini/omp-harness-guide/codebase-design)

Something wrong with this skill or its page? Tell us.