Agent Plugins Marketplace
All plugins

codebase-design

v1.0.0

Before writing a new interface (module boundary, class API, function signature, or service contract) that at least two call sites will depend on, that crosses a module/service/team/persistence boundary, or that will be expensive to change later — produce 3+ radically different candidate designs and compare them on depth, locality, and seam placement before picking one. Use on "before committing to an interface", "design this API/module/class boundary", "how should this be structured", "compare interface designs", "is this the right abstraction", "design it twice", reviewing a proposed interface shape in a PR — or self-trigger whenever about to write a new interface meeting that bar.

Claude Code1 Skill

By Jordan RichlenLicense: MIT1 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes
Claude Code
Parsed components
1 skill or MCP entry
Source updated
Sep 24, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology

Install codebase-design for Claude Code

Installs for the current user
claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install codebase-design@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/JRichlen/agent-plugins

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/codebase-design/.

Plugin files

plugins/codebase-design/
├── .claude-plugin/plugin.json
└── skills/codebase-design/SKILL.md

Included Skills1

codebase-designskills/codebase-design/SKILL.md

Before writing a new interface (module boundary, class API, function signature, or service contract) that at least two call sites will depend on, that crosses a module/service/team/persistence boundary, or that will be expensive to change later — produce 3+ radically different candidate designs and compare them on depth, locality, and seam placement before picking one. Use on "before committing to an interface", "design this API/module/class boundary", "how should this be structured", "compare interface designs", "is this the right abstraction", "design it twice", reviewing a proposed interface shape in a PR — or self-trigger whenever about to write a new interface meeting that bar.

Plugin manifests1

plugins/codebase-design/.claude-plugin/plugin.json
{
  "name": "codebase-design",
  "version": "1.0.0",
  "description": "Before writing a new interface (module boundary, class API, function signature, or service contract) that at least two call sites will depend on, that crosses a module/service/team/persistence boundary, or that will be expensive to change later — produce 3+ radically different candidate designs and compare them on depth, locality, and seam placement before picking one. Use on \"before committing to an interface\", \"design this API/module/class boundary\", \"how should this be structured\", \"compare interface designs\", \"is this the right abstraction\", \"design it twice\", reviewing a proposed interface shape in a PR — or self-trigger whenever about to write a new interface meeting that bar.",
  "author": {
    "name": "Jordan Richlen"
  },
  "repository": "https://github.com/JRichlen/agent-plugins",
  "homepage": "https://github.com/JRichlen/agent-plugins/tree/main/plugins/codebase-design",
  "license": "MIT",
  "keywords": [
    "interface-design",
    "api-design",
    "deep-modules",
    "seam-design",
    "design-comparison"
  ],
  "skills": "./skills/",
  "commands": "./commands/"
}

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[codebase-design on Agent Plugins Marketplace](https://pluginsmp.com/plugins/codebase-design)