📐 Principled Marketplace

A curated Claude Code plugin marketplace for specification-first development.

---

A Claude Code plugin marketplace hosting first-party and community plugins for the Principled specification-first methodology. Add the marketplace once, install any plugin.

📦 Available Plugins

First-Party

Plugin	Category	Description
principled-docs	documentation	Scaffold, author, and enforce module documentation structure following the Principled specification-first methodology (v0.3.1)
principled-implementation	implementation	Orchestrate DDD plan execution via worktree-isolated Claude Code agents (v0.1.0)
principled-github	workflow	Integrate the principled workflow with GitHub native features: issues, PRs, templates, actions, CODEOWNERS, and labels (v0.1.0)
principled-quality	quality	Connect code reviews to the principled documentation pipeline with spec-driven checklists and review tracking (v0.1.0)
principled-release	workflow	Generate changelogs from the documentation pipeline, verify release readiness, and coordinate versioned releases (v0.1.0)
principled-architecture	architecture	Map modules to governing ADRs, detect architectural drift, audit governance coverage, and sync architecture docs (v0.1.0)

Community

No community plugins yet. See Contributing to submit one.

⚡ Quick Start

Add the Marketplace

/plugin marketplace add alexnodeland/principled

Install a Plugin

/plugin install principled-docs@principled-marketplace
/plugin install principled-implementation@principled-marketplace
/plugin install principled-github@principled-marketplace
/plugin install principled-quality@principled-marketplace
/plugin install principled-release@principled-marketplace
/plugin install principled-architecture@principled-marketplace

Team-Wide Adoption

Add to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "principled-marketplace": {
      "source": {
        "source": "github",
        "repo": "alexnodeland/principled"
      }
    }
  },
  "enabledPlugins": {
    "principled-docs@principled-marketplace": true,
    "principled-implementation@principled-marketplace": true,
    "principled-github@principled-marketplace": true,
    "principled-quality@principled-marketplace": true,
    "principled-release@principled-marketplace": true,
    "principled-architecture@principled-marketplace": true
  }
}

📂 Structure

principled/
├── .claude-plugin/
│   └── marketplace.json         # Plugin catalog
├── plugins/                     # First-party plugins
│   ├── principled-docs/         # Documentation structure plugin
│   ├── principled-implementation/ # Plan execution plugin
│   ├── principled-github/       # GitHub integration plugin
│   ├── principled-quality/      # Code review quality plugin
│   ├── principled-release/     # Release lifecycle plugin
│   └── principled-architecture/ # Architecture governance plugin
├── external_plugins/            # Community plugins
├── docs/                        # Marketplace governance
│   ├── proposals/               # RFCs
│   ├── plans/                   # Implementation plans
│   ├── decisions/               # ADRs
│   └── architecture/            # Design docs
└── .claude/                     # Dev configuration

🤝 Contributing a Plugin

First-Party Plugins

First-party plugins live in plugins/. They are maintained by the project and must:

• Have a valid .claude-plugin/plugin.json manifest
• Follow marketplace lint standards (ShellCheck, shfmt, markdownlint, Prettier)
• Include a README.md with installation, usage, and skill/hook documentation
• Be self-contained (no cross-plugin imports)

Community Plugins

Community plugins live in external_plugins/. Submit via pull request:

1. Create external_plugins/<your-plugin>/ with the standard plugin structure
2. Include .claude-plugin/plugin.json with author and homepage/repository fields
3. Include a README.md
4. Ensure all CI checks pass
5. A maintainer will review and add the entry to marketplace.json

See CONTRIBUTING.md for the full guide.

📋 Categories

Category	Description
documentation	Documentation structure, authoring, and enforcement
implementation	Plan execution, orchestration, and agent automation
workflow	Development workflow automation and process enforcement
quality	Code quality, review, and standards enforcement
architecture	Architectural governance and decision tracking

---

_{Built with the Claude Code plugin system · Principled specification-first methodology}