中文文档

What Pomelo Does

Pomelo is an OpenCode plugin that turns agent work into a skill-first, auditable workflow. It synchronizes agents, commands, skills, and reference guides into OpenCode, then helps the primary agent route intent, load the right Superpowers workflow, delegate specialist work, and report evidence.

Pomelo is not just a set of prompts. It provides:

| Capability | Description | | --- | --- | | Virtual resources | Uses @suknna/opencode-virtual to load Markdown agents, commands, and skills as runtime resources | | Superpowers bridge | Exposes bundled Superpowers through OpenCode's native skill tool | | Grovekeeper workflow guidance | Routes each turn by intent: research, brainstorm, plan, debug, implement, review, verify, or finish | | Subagent session registry | Persists scoped subagent task_id reuse under .pomelo_mem/subagent-sessions.json | | Ralph loop | Lets long-running tasks continue on OpenCode idle events until a completion promise is met | | Pomelo config bridge | Loads global/project pomelo.jsonc for agent model overrides and skill disabling |

Installation For Humans

Copy and paste this prompt to your LLM agent (Claude Code, OpenCode, Codex, Cursor, etc.):

Install and configure Pomelo by following the instructions here:
https://raw.githubusercontent.com/Suknna/pomelo/refs/heads/main/docs/guide/installation.md

Or read docs/guide/installation.md and do it manually, but seriously, let an agent do it. Humans fat-finger configs.

If you need custom behavior (non-default paths, enterprise policy, custom auth flow), switch to manual installation and adapt commands from docs/guide/installation.md.

Workflow Model

Pomelo now relies on native OpenCode tools, bundled skills, and explicit evidence instead of a reducer-driven phase tracker.

In a typical Grovekeeper-led task, the agent:

• classifies the current user intent before acting
• loads the matching Superpowers skill before governed workflows
• delegates research, implementation, plan review, UI reference research, or code review when useful
• records scoped subagent sessions when a workflow needs repeatable delegation
• reports changes, verification evidence, and any remaining risk in the final response

Pomelo Agents

Pomelo agents are Markdown resources in templates/agents/, loaded through opencode-virtual, then synced to OpenCode's native agent directory.

| Agent | Role | | --- | --- | | pomelo-grovekeeper | Main coordinator. Routes intent, applies the Superpowers workflow layer, delegates work, and owns handoffs | | pomelo-grafter | Implementer. Performs code changes after plan and workspace gates are ready | | pomelo-forager | Reference researcher. Finds official docs, examples, and prior art without modifying code | | pomelo-taster | Plan reviewer. Reviews specs/plans for feasibility, missing wiring, and blocker risks | | pomelo-rindguard | Code reviewer. Performs deep code review and risk analysis | | pomelo-bloomsmith | Advisory UI aesthetics researcher. Finds strong visual references and design system candidates |

Built-In Commands

Commands are Markdown resources in templates/commands/ with OpenCode frontmatter and runtime contracts.

| Command | Owner | Purpose | | --- | --- | --- | | /init-deep | pomelo-grovekeeper | Inspect a project and generate layered AGENTS.md knowledge | | /ralph_loop | pomelo-grovekeeper | Start a Ralph loop so the task can continue on idle events until completion | | /review-deep | pomelo-grovekeeper | Run deep code review through pomelo-rindguard units |

Commands report progress through natural-language evidence, captured subagent output, and native OpenCode tool results.

UI Reference Workflow

UI work stays inside the normal Grovekeeper-led Superpowers flow. pomelo-bloomsmith does not own a separate UI runtime and does not write the final spec. It acts as an advisory aesthetics researcher that helps Grovekeeper find strong visual directions, design systems, and real UI references.

Rules:

• Grovekeeper remains responsible for brainstorming, user questions, final choices, spec, and plan.
• Bloomsmith returns a UI Reference Report, not a final spec or plan.
• User answers drive the visual direction; Bloomsmith only supplies options and evidence.
• Pomelo does not wrap DESIGNmd. UI reference research loads the bundled native designmd skill, then calls the official DESIGNmd CLI directly:

designmd search "dark fintech dashboard"
designmd tags
designmd download <design-system> -o ./DESIGN.md

If the CLI is not installed or not visible to OpenCode, install it with npm install -g designmd or use npx designmd. Official docs: https://designmd.ai/cli.

get, download, and upload require DESIGNMD_API_KEY, matching the official DESIGNmd CLI. Downloading DESIGN.md should happen only after the user selects a design system.

Tools Exposed to Agents

| Tool | Purpose | | --- | --- | | OpenCode skill | Load complete bundled Superpowers skill bodies from the native skill registry | | pomelo_ralph_loop | Start, inspect, or stop idle-time task continuation | | pomelo_subagent_driven_execution | Start a two-subagent implement/review workflow with pomelo-grafter and pomelo-rindguard; inspect details through native OpenCode subagent sessions |

Project Layout

src/
  index.ts                 OpenCode plugin entry
  cli.ts                   pomelo CLI
  config/                  pomelo.jsonc loading and OpenCode config application
  tools/                   OpenCode tools exposed to agents
  hooks/                   system transform hooks and subagent capture
  shared/                  shared helpers for subagent session metadata
  virtual/                 opencode-virtual resource loading
templates/
  agents/                  Pomelo agent prompts
  commands/                OpenCode command prompts
  skills/                  Superpowers skill bodies bundled with Pomelo
packages/
  opencode-virtual/        Virtual resource loader package

License

MIT