plugins/README.md

# agentic/plugins

Multi-agent plugin marketplace for Claude Code, Codex, and Gemini CLI. Autonomous development workflows, tiered engineering personas, and cross-agent MCP coordination.

## Installation

Claude Code:

```bash
# Install the full agentic plugin (agents, flows, patterns)
claude plugin add agentic/plugins/claude/agentic

# Or install specific Claude plugins
claude plugin add agentic/plugins/claude/code
claude plugin add agentic/plugins/claude/review
claude plugin add agentic/plugins/claude/qa
```

Codex:

- Codex plugins live at `codex/`.

Gemini CLI:

- Extension lives at `google/gemini-cli`.

## Shared MCP Server

A vendor-neutral MCP server lives in `mcp/` and is registered in `.mcp.json` at the repo root.

Run locally:

```bash
go run ./mcp/
```

Tools:

- `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 a first-class feature under `codex/ethics`.

- `codex/ethics/MODAL.md`
- `codex/ethics/kernel/axioms.json`

## Plugin Suites

Claude plugins:

- `claude/agentic` — Autonomous agents, flow orchestration, patterns (14 agents, 11 skills)
- `claude/api` — API client generation
- `claude/ci` — CI pipeline integration
- `claude/code` — Core development (22 commands, hooks, formatting)
- `claude/collect` — Data collection, ledger papers archive
- `claude/coolify` — Coolify deployment
- `claude/core` — Module management
- `claude/issue` — Issue CRUD via Forgejo
- `claude/perf` — Performance profiling
- `claude/qa` — QA, lint enforcement
- `claude/review` — PR review, security audit
- `claude/verify` — Pre-push verification

Codex plugins:

- `codex/awareness` — Monorepo awareness
- `codex/ethics` — Ethics modal and axioms kernel
- `codex/guardrails` — Safety 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`

## 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
│   └── ...                   # ci, qa, review, verify, etc.
├── codex/                    # Codex plugin suite + ethics kernel
├── google/                   # Gemini CLI extension
├── mcp/                      # Shared MCP stdio server (Go)
└── README.md
```

## Package Registry

Published via CI to `dappco.re/claude/` (Forgejo generic packages on forge.lthn.ai).

## License

EUPL-1.2

## Links

- [Forge](https://forge.lthn.ai/agentic/plugins)
- [Lethean](https://lethean.io)
- [Claude Code Documentation](https://docs.anthropic.com/claude-code)