agent/docs/RFC-AGENT-PLUGIN-RESTRUCTURE.md

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:

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)