plugins/CLAUDE.md

CLAUDE.md

This file guides Claude Code when working inside the agentic/plugins repository.

Overview

agentic/plugins is a multi-agent plugin marketplace hosting Claude, Codex, and Gemini CLI plugin suites. A shared MCP server powers marketplace discovery and ethics checks across tools.

Marketplace

Install everything via the marketplace:

claude plugin add agentic/plugins

Install a specific Claude plugin:

claude plugin add agentic/plugins/claude/agentic
claude plugin add agentic/plugins/claude/code

The marketplace manifest lives at .claude-plugin/marketplace.json.

Shared MCP Server

The vendor-neutral MCP server is registered in .mcp.json and runs via stdio:

go run ./mcp/

Tools exposed:

• marketplace_list — returns the full marketplace registry as structured data
• marketplace_plugin_info — returns plugin metadata, commands, and skills by name
• core_cli — runs approved core CLI commands (dev, go, php, build only)
• ethics_check — returns the ethics modal and axioms kernel

Ethics Kernel

The Axioms of Life ethics kernel is first-class and lives at:

• codex/ethics/MODAL.md
• codex/ethics/kernel/axioms.json

Repository Structure

agentic/plugins/
├── .claude-plugin/           # Marketplace manifest
├── .mcp.json                 # MCP server registry
├── claude/                   # Claude Code plugin suite
│   ├── agentic/              # Autonomous agents + flow orchestration
│   ├── code/                 # Core development workhorse
│   └── ...                   # api, ci, collect, core, issue, perf, qa, review, verify
├── codex/                    # Codex plugin suite + ethics kernel
├── google/                   # Gemini CLI extension
├── mcp/                      # Shared MCP stdio server (Go)
└── README.md

Plugin Suites

Claude plugins:

• claude/agentic — Autonomous agents, flow orchestration, patterns
• claude/api, claude/ci, claude/code, claude/collect, claude/coolify
• claude/core, claude/issue, claude/perf, claude/qa, claude/review, claude/verify

Codex plugins:

• codex/awareness, codex/ethics, codex/guardrails
• codex/api, codex/ci, codex/code, codex/collect, codex/coolify
• codex/core, codex/issue, codex/perf, codex/qa, codex/review, codex/verify

Gemini extension:

• google/gemini-cli

Core CLI Philosophy

Always use core CLI instead of raw commands. The core binary handles the full E2E development lifecycle for Go and PHP ecosystems.

Instead of...	Use...
go test	core go test
go build	core build
golangci-lint	core go lint
composer test	core php test
./vendor/bin/pint	core php fmt

Development

Adding a new Claude plugin:

1. Create claude/<name>/.claude-plugin/plugin.json
2. Add commands to claude/<name>/commands/
3. Register in .claude-plugin/marketplace.json

Coding Standards

• UK English: colour, organisation, centre
• Shell scripts: use #!/bin/bash, read JSON with jq
• Hook output: JSON with decision (approve/block) and optional message
• License: EUPL-1.2