@arborship/codebase

Architecture decision (MAR-69/MAR-95): This is a PROMPT/ASSETS-ONLY package. It contains no TypeScript source code and produces no compiled output. The package ships markdown skill files, agent prompts, slash commands, and plugin manifests for consumption by Claude Code (.claude-plugin/) and OpenCode (opencode/). There is no src/ directory and no build step. The main/exports fields in package.json pointing at opencode/plugin/index.js are vestigial placeholders — that file does not exist and is not needed for the package to function as a prompt plugin.

Domain knowledge for the Levi monorepo. Provides instant architectural context for each layer of the stack.

Works with both Claude Code and OpenCode

Installation

For Claude Code

Reference the plugin directly - Claude Code reads from .claude-plugin/plugin.json.

For OpenCode

Add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@arborship/codebase"]
}

Features

• 7 Domain Skills: CLI, SDK, Core, Drivers, Control Plane, Desktop, Agent Supervisor
• 5 Agents: Add API endpoint, add CLI command, add driver, debug VM, refresh knowledge
• 3 Slash Commands: domains, refresh-knowledge, and capture-discoveries
• Custom Tools: getDomainContext and findDomainForFile

Domain Skills

• cli-domain - CLI layer (oclif)
• sdk-domain - SDK layer
• core-domain - Core layer (libvirt)
• drivers-domain - Drivers layer
• control-plane-domain - Control plane layer
• desktop-domain - Desktop layer (Electron)
• agent-supervisor-domain - Agent supervisor layer

Agents

• add-api-endpoint - Add API endpoints
• add-cli-command - Add CLI commands
• add-driver - Add platform drivers
• debug-vm - Debug VM issues
• refresh-knowledge - Refresh codebase knowledge

Slash Commands

• domains - Show Levi domain quick reference
• refresh-knowledge - Compare skills/docs against current source and propose updates
• capture-discoveries - Persist new debugging/provisioning discoveries into AGENTS/docs/skills/commands

Custom Tools

getDomainContext

Get architectural context for a domain:

getDomainContext({ domain: "sdk" })

findDomainForFile

Determine which domain a file belongs to:

findDomainForFile({ filePath: "packages/host/sdk/src/index.ts" })

License

Apache-2.0 — see the LICENSE file in this package.