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

```bash
claude plugin add agentic/plugins
```

Install a specific Claude plugin:

```bash
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:

```bash
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