9b0d2f2fef
- README: agentic/plugins branding, forge.lthn.ai links, dAppCo.re registry - CLAUDE.md: updated repo structure and install paths - marketplace.json: owner=Lethean, registry=forge.lthn.ai, org=agentic - .mcp.json: renamed server to AGENTIC_MARKETPLACE Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
107 lines
3.2 KiB
Markdown
107 lines
3.2 KiB
Markdown
# 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
|