architecture-review

dev-digest-ai-marketplace

A Claude Code plugin marketplace: a catalog of plugins (skills, agents, commands, hooks, MCP servers) distributed through a single marketplace.json.

Add this marketplace

/plugin marketplace add kolodgeeva/dev-digest-ai-marketplace

(or, for local testing before this is pushed: /plugin marketplace add ./)

Install a plugin

/plugin install <plugin-name>@dev-digest-ai-marketplace

Browse what's available at the catalog site (search, filters, per-item docs, changelog), in plugins/ in this repo, or via /plugin marketplace list after adding it.

Repository layout

.claude-plugin/marketplace.json   # the catalog — lists every plugin and where to find it
plugins/<plugin-name>/            # one directory per plugin
docs/                             # contributor-facing guidelines
  PLUGIN-GUIDELINES.md              # plugin structure, manifest, dependency rules
  SECURITY.md                       # permissions, secrets policy, script review bar
  RELEASES.md                       # SemVer, tagging, update/rollback flow
  MARKETPLACE-SITE-SPEC.md          # spec for the catalog site below
scripts/
  validate-marketplace.mjs          # dependency-free structural linter, also run in CI
  release.mjs                       # bump/tag/rollback tooling — see docs/RELEASES.md
  build-site-data.mjs               # builds site/public/data/*.json from plugins/ for the catalog site
site/                              # the catalog site itself (React + Vite; `npm run dev` for local dev)
design/catalog-prototype/          # visual/UX design reference the site is built from
.github/workflows/
  validate.yml                      # CI: linter + `claude plugin validate` + site build on every PR
  deploy-pages.yml                  # builds site data, builds the site (`npm run build`), deploys to GitHub Pages on push to main
CONTRIBUTING.md                   # how to add or change a plugin
CODEOWNERS                        # review ownership
MARKETPLACE-RESEARCH.md           # background research this setup is based on

Contributing

See CONTRIBUTING.md. Short version: read docs/PLUGIN-GUIDELINES.md, add your plugin under plugins/, register it in marketplace.json, run node scripts/validate-marketplace.mjs and claude plugin validate ., open a PR.