diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index fb54b61..1682c4d 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,12 +1,22 @@ { "$schema": "https://anthropic.com/claude-code/marketplace.schema.json", - "name": "host-uk", - "description": "Host UK development plugins for Claude Code, Codex, and Gemini", + "name": "agentic-plugins", + "description": "Multi-agent plugin marketplace for Claude Code, Codex, and Gemini CLI", "owner": { - "name": "Host UK", - "email": "hello@host.uk.com" + "name": "Lethean", + "email": "developers@lethean.io" }, + "registry": "forge.lthn.ai", + "organization": "agentic", + "repository": "plugins", "plugins": [ + { + "name": "claude-agentic", + "description": "Autonomous agents, flow orchestration, tiered engineering personas, patterns", + "version": "0.5.0", + "source": "./claude/agentic", + "category": "workflow" + }, { "name": "claude-api", "description": "API client generation helpers", @@ -16,7 +26,7 @@ }, { "name": "claude-ci", - "description": "CI integration - GitHub Actions, test automation", + "description": "CI integration - pipeline automation, test runners", "version": "0.1.0", "source": "./claude/ci", "category": "workflow" @@ -30,7 +40,7 @@ }, { "name": "claude-collect", - "description": "Data collection via Borg CLI - /collect:github, /collect:website, /collect:excavate, /collect:papers", + "description": "Data collection - ledger papers, project archaeology, blockchain research", "version": "0.1.0", "source": "./claude/collect", "category": "data-collection" @@ -44,21 +54,21 @@ }, { "name": "claude-core", - "description": "Core commands for project maintenance", + "description": "Core module management - clean, migrate, release", "version": "0.1.0", "source": "./claude/core", "category": "workflow" }, { "name": "claude-issue", - "description": "Integration with GitHub Issues", + "description": "Issue management via Forgejo API", "version": "0.1.0", "source": "./claude/issue", "category": "productivity" }, { "name": "claude-perf", - "description": "Performance profiling helpers for Go and PHP", + "description": "Performance profiling for Go and PHP", "version": "0.1.0", "source": "./claude/perf", "category": "monitoring" @@ -92,106 +102,8 @@ "category": "ethics" }, { - "name": "codex-awareness", - "description": "Codex awareness guidance for the core-agent monorepo", - "version": "0.1.1", - "source": "./codex/awareness", - "category": "productivity" - }, - { - "name": "codex-ethics", - "description": "Ethics modal and axioms kernel for Codex", - "version": "0.1.1", - "source": "./codex/ethics", - "category": "ethics" - }, - { - "name": "codex-guardrails", - "description": "Safety guardrails with a focus on safe string handling", - "version": "0.1.1", - "source": "./codex/guardrails", - "category": "security" - }, - { - "name": "codex-api", - "description": "Codex API plugin", - "version": "0.1.1", - "source": "./codex/api", - "category": "development" - }, - { - "name": "codex-ci", - "description": "Codex CI plugin", - "version": "0.1.1", - "source": "./codex/ci", - "category": "workflow" - }, - { - "name": "codex-code", - "description": "Codex code workflow plugin", - "version": "0.1.1", - "source": "./codex/code", - "category": "development" - }, - { - "name": "codex-collect", - "description": "Codex collection plugin", - "version": "0.1.1", - "source": "./codex/collect", - "category": "data-collection" - }, - { - "name": "codex-coolify", - "description": "Codex Coolify plugin", - "version": "0.1.1", - "source": "./codex/coolify", - "category": "deployment" - }, - { - "name": "codex-core", - "description": "Codex core plugin", - "version": "0.1.1", - "source": "./codex/core", - "category": "workflow" - }, - { - "name": "codex-issue", - "description": "Codex issue plugin", - "version": "0.1.1", - "source": "./codex/issue", - "category": "productivity" - }, - { - "name": "codex-perf", - "description": "Codex performance plugin", - "version": "0.1.1", - "source": "./codex/perf", - "category": "monitoring" - }, - { - "name": "codex-qa", - "description": "Codex QA plugin", - "version": "0.1.1", - "source": "./codex/qa", - "category": "testing" - }, - { - "name": "codex-review", - "description": "Codex review plugin", - "version": "0.1.1", - "source": "./codex/review", - "category": "security" - }, - { - "name": "codex-verify", - "description": "Codex verify plugin", - "version": "0.1.1", - "source": "./codex/verify", - "category": "testing" - }, - { - "name": "gemini-core-agent", - "description": "Host UK Core Agent Extension for Gemini CLI", + "name": "gemini-cli", + "description": "Gemini CLI extension with core agent integration", "version": "0.1.1", "source": "./google/gemini-cli", "category": "development" diff --git a/.mcp.json b/.mcp.json index cf49328..0eff3fa 100644 --- a/.mcp.json +++ b/.mcp.json @@ -1,6 +1,6 @@ { "mcpServers": { - "HOST_UK_MARKETPLACE": { + "AGENTIC_MARKETPLACE": { "command": "go", "args": [ "run", diff --git a/CLAUDE.md b/CLAUDE.md index 49f4f87..ab9fb22 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,30 +1,31 @@ # CLAUDE.md -This file guides Claude Code when working inside the Host UK core-agent repository. +This file guides Claude Code when working inside the agentic/plugins repository. ## Overview -**core-agent** is a unified marketplace hosting Claude and Codex plugin suites plus the Gemini CLI extension. A shared MCP server powers marketplace discovery and ethics checks across tools. +**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 unified marketplace: +Install everything via the marketplace: ```bash -claude plugin add host-uk/core-agent +claude plugin add agentic/plugins ``` Install a specific Claude plugin: ```bash -claude plugin add host-uk/core-agent/claude/code +claude plugin add agentic/plugins/claude/agentic +claude plugin add agentic/plugins/claude/code ``` -The marketplace manifest lives at `core-agent/.claude-plugin/marketplace.json`. +The marketplace manifest lives at `.claude-plugin/marketplace.json`. ## Shared MCP Server -The vendor-neutral MCP server is registered in `core-agent/.mcp.json` and runs via stdio: +The vendor-neutral MCP server is registered in `.mcp.json` and runs via stdio: ```bash go run ./mcp/ @@ -41,20 +42,22 @@ Tools exposed: The Axioms of Life ethics kernel is first-class and lives at: -- `core-agent/codex/ethics/MODAL.md` -- `core-agent/codex/ethics/kernel/axioms.json` +- `codex/ethics/MODAL.md` +- `codex/ethics/kernel/axioms.json` ## Repository Structure ``` -core-agent/ -├── .claude-plugin/ # Unified marketplace manifest -├── .mcp.json # MCP server registry -├── claude/ # Claude plugin suite -├── codex/ # Codex plugin suite + ethics kernel -├── google/ # Gemini CLI extension -├── mcp/ # Shared MCP stdio server -├── CLAUDE.md +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 ``` @@ -62,34 +65,15 @@ core-agent/ Claude plugins: -- `claude/api` -- `claude/ci` -- `claude/code` -- `claude/collect` -- `claude/coolify` -- `claude/core` -- `claude/issue` -- `claude/perf` -- `claude/qa` -- `claude/review` -- `claude/verify` +- `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` +- `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: @@ -99,17 +83,13 @@ Gemini extension: Always use `core` CLI instead of raw commands. The `core` binary handles the full E2E development lifecycle for Go and PHP ecosystems. -### Command Mappings - | Instead of... | Use... | |---------------|--------| | `go test` | `core go test` | | `go build` | `core build` | -| `go fmt` | `core go fmt` | | `golangci-lint` | `core go lint` | | `composer test` | `core php test` | | `./vendor/bin/pint` | `core php fmt` | -| `./vendor/bin/phpstan` | `core php stan` | ## Development @@ -119,15 +99,9 @@ Adding a new Claude plugin: 2. Add commands to `claude//commands/` 3. Register in `.claude-plugin/marketplace.json` -Adding a new Codex plugin: - -1. Create `codex//.codex-plugin/plugin.json` -2. Add commands to `codex//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 CIC +- License: EUPL-1.2 diff --git a/README.md b/README.md index ae41804..8efef8a 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,32 @@ -# core-agent +# agentic/plugins -A unified marketplace of Host UK plugins for Claude Code, Codex, and the Gemini CLI. This repo hosts the Claude and Codex suites alongside a shared MCP server and the Axioms of Life ethics kernel. - -## Marketplace - -The public marketplace manifest lives at `core-agent/.claude-plugin/marketplace.json` and lists all Claude, Codex, and Gemini entries. +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 everything via marketplace -claude plugin add host-uk/core-agent +# Install the full agentic plugin (agents, flows, patterns) +claude plugin add agentic/plugins/claude/agentic # Or install specific Claude plugins -claude plugin add host-uk/core-agent/claude/code -claude plugin add host-uk/core-agent/claude/review -claude plugin add host-uk/core-agent/claude/qa +claude plugin add agentic/plugins/claude/code +claude plugin add agentic/plugins/claude/review +claude plugin add agentic/plugins/claude/qa ``` -Gemini CLI: - -- Extension lives at `core-agent/google/gemini-cli`. - Codex: -- Codex plugins live at `core-agent/codex`. +- Codex plugins live at `codex/`. + +Gemini CLI: + +- Extension lives at `google/gemini-cli`. ## Shared MCP Server -A vendor-neutral MCP server lives in `core-agent/mcp` and is registered in `.mcp.json` at the repo root. +A vendor-neutral MCP server lives in `mcp/` and is registered in `.mcp.json` at the repo root. Run locally: @@ -47,43 +43,35 @@ Tools: ## Ethics Kernel -The Axioms of Life ethics kernel is a first-class feature under `core-agent/codex/ethics`. +The Axioms of Life ethics kernel is a first-class feature under `codex/ethics`. -- `core-agent/codex/ethics/MODAL.md` -- `core-agent/codex/ethics/kernel/axioms.json` +- `codex/ethics/MODAL.md` +- `codex/ethics/kernel/axioms.json` ## Plugin Suites Claude plugins: -- `claude/api` -- `claude/ci` -- `claude/code` -- `claude/collect` -- `claude/coolify` -- `claude/core` -- `claude/issue` -- `claude/perf` -- `claude/qa` -- `claude/review` -- `claude/verify` +- `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` -- `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` +- `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: @@ -92,28 +80,22 @@ Gemini extension: ## Repository Structure ``` -core-agent/ -├── .claude-plugin/ # Unified marketplace manifest -├── .mcp.json # MCP server registry -├── claude/ # Claude plugin suite -├── codex/ # Codex plugin suite + ethics kernel -├── google/ # Gemini CLI extension -├── mcp/ # Shared MCP stdio server -├── CLAUDE.md +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 ``` -## Core CLI Integration +## Package Registry -These plugins enforce the `core` CLI for development commands: - -| 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` | +Published via CI to `dappco.re/claude/` (Forgejo generic packages on forge.lthn.ai). ## License @@ -121,6 +103,6 @@ EUPL-1.2 ## Links -- [Host UK](https://host.uk.com) +- [Forge](https://forge.lthn.ai/agentic/plugins) +- [Lethean](https://lethean.io) - [Claude Code Documentation](https://docs.anthropic.com/claude-code) -- [Issues](https://github.com/host-uk/core-agent/issues)