be78c27561
AX principles + go/agent + core/agent + php/agent specs. Temporary — needed in-repo until core-agent mount bug is fixed. Co-Authored-By: Virgil <virgil@lethean.io>
117 lines
4.2 KiB
Markdown
117 lines
4.2 KiB
Markdown
# Plugin Restructure: dappcore → core + API/MCP Integration
|
|
|
|
## Context
|
|
|
|
3 skeleton plugins (core-go, core-php, infra) need building out. The go-agent repo has 67 commands across 11 plugins that can enrich them. Plugins need configuring to work with `{api,mcp}.lthn.sh` endpoints (JSON via `Accept` header, default returns HTML).
|
|
|
|
## Step 1: Rename dappcore-go → core-go
|
|
|
|
**Files to modify:**
|
|
- `plugins/dappcore-go/.claude-plugin/plugin.json` — change name, update metadata
|
|
- Rename directory: `dappcore-go/` → `core-go/`
|
|
|
|
**Keep existing skills** (they're solid):
|
|
- `core/SKILL.md` — CLI reference & decision tree
|
|
- `core-go/SKILL.md` — Go framework patterns (pkg structure, CLI helpers, i18n, test naming)
|
|
- `go-agent/SKILL.md` — Autonomous dev workflow (7-step loop, PR management, CodeRabbit)
|
|
|
|
**Add from go-agent/claude/code:**
|
|
- `commands/qa.md` — QA fix loop (from code plugin, Go-specific)
|
|
- `commands/commit.md` — Smart conventional commit
|
|
- `commands/review.md` — Code review (from review plugin)
|
|
- `commands/verify.md` — Verification gate (from verify plugin)
|
|
|
|
**Add agents:**
|
|
- `agents/go-developer.md` — Go dev agent persona (derived from go-agent skill)
|
|
|
|
**Add:**
|
|
- `README.md`
|
|
- `marketplace.yaml` (template from agentic-flows)
|
|
|
|
## Step 2: Rename dappcore-php → core-php
|
|
|
|
**Files to modify:**
|
|
- `plugins/dappcore-php/.claude-plugin/plugin.json` — change name, update metadata
|
|
- Rename directory: `dappcore-php/` → `core-php/`
|
|
|
|
**Keep existing skills:**
|
|
- `core-php/SKILL.md` — Module structure, Boot class, Action pattern, multi-tenant
|
|
- `php-agent/SKILL.md` — Autonomous PHP dev workflow (TDD, CodeRabbit, issue loop)
|
|
|
|
**Add from go-agent/claude/code:**
|
|
- `commands/qa.md` — QA fix loop (PHP-specific: pest, pint, analyse)
|
|
- `commands/commit.md` — Smart conventional commit
|
|
- `commands/review.md` — Code review
|
|
- `commands/verify.md` — Verification gate
|
|
|
|
**Add agents:**
|
|
- `agents/php-developer.md` — PHP/Laravel dev agent persona
|
|
|
|
**Add:**
|
|
- `README.md`
|
|
- `marketplace.yaml`
|
|
|
|
## Step 3: Update infra plugin
|
|
|
|
**Keep existing skills** (content is detailed and good):
|
|
- `infra/SKILL.md` — Machine inventory, NOC services, network config
|
|
- `gitea/SKILL.md` — Forge/Forgejo CLI commands, org structure, mirrors
|
|
|
|
**Rename skill:** `agents/` → `brand/` (it's about Vi mascot & brand voice, not agent definitions)
|
|
|
|
**Add agents:**
|
|
- `agents/infra-ops.md` — Infrastructure operations agent
|
|
|
|
**Add from go-agent/claude/coolify:**
|
|
- `commands/deploy.md` — Service deployment
|
|
- `commands/status.md` — Deployment status check
|
|
|
|
**Add:**
|
|
- `README.md`
|
|
- `marketplace.yaml`
|
|
|
|
**Fix plugin.json:** Update skill references after rename
|
|
|
|
## Step 4: API/MCP endpoint configuration
|
|
|
|
Add a shared skill or pattern file that documents the endpoint convention for all plugins:
|
|
|
|
**Create `core-go/skills/api-endpoints/SKILL.md`** (and symlink or copy to core-php, infra):
|
|
|
|
Content covers:
|
|
- `api.lthn.sh` — REST API
|
|
- `mcp.lthn.sh` — MCP bridge endpoint
|
|
- **Must send `Accept: application/json`** — default returns HTML
|
|
- **Must send `Content-Type: application/json`** for POST bodies
|
|
- Auth: Bearer token in `Authorization` header
|
|
- REST convention: `/v1/{resource}`
|
|
- This is both OSS (people run their own lthn.sh) and production
|
|
|
|
**Update `.mcp.json`** in core-go and core-php to reference `core mcp serve` (same pattern as agentic-flows).
|
|
|
|
## Step 5: Add marketplace.yaml to all 3 plugins
|
|
|
|
Template from agentic-flows, adjusted per plugin:
|
|
```yaml
|
|
marketplace:
|
|
registry: forge.lthn.ai
|
|
organization: core
|
|
repository: {plugin-name}
|
|
auto_update: true
|
|
check_interval: 24h
|
|
```
|
|
|
|
## Verification
|
|
|
|
1. Check plugin structure matches convention: `.claude-plugin/plugin.json` at root, commands/agents/skills at root level
|
|
2. Validate all SKILL.md files have proper YAML frontmatter
|
|
3. Validate all command .md files have proper frontmatter with name/description
|
|
4. Confirm no hardcoded paths (use `${CLAUDE_PLUGIN_ROOT}` where needed)
|
|
5. Test that `core mcp serve` still works with updated .mcp.json configs
|
|
|
|
## Out of Scope
|
|
|
|
- lethean & cryptonote-archive plugins (reference material)
|
|
- go-agent/claude/ plugins (stay in Go repo, not merged into shared plugins)
|
|
- EaaS subsystem references (stripped for OSS release)
|
|
- Codex/Gemini plugins (stay in go-agent)
|