principled-docs

📐 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: