mirror of
https://github.com/LerianStudio/ring
synced 2026-04-21 21:47:49 +00:00
0e7e5ca396
Removes the hard-coded `model: "opus"` requirement from all agent definitions, skill examples, and command documentation. The orchestrator is now responsible for model selection, making the agent framework more flexible and model-agnostic. Key changes include: - Removing the `model` parameter from all agent frontmatter and Task tool examples. - Deleting the "Model Requirement" hard gate and self-verification sections from all agent prompts. This simplifies the prompts and removes model-specific enforcement logic. - Updating core documentation (ARCHITECTURE, MANUAL, README) to reflect that model selection is an orchestrator concern. - Removing redundant `changelog` and `last_updated` fields from agent frontmatter, as this information is tracked by source control. This architectural shift allows the orchestrator to dynamically choose the best model for a given task based on complexity, cost, or speed, without being constrained by the agent's definition. It simplifies agent maintenance and prepares the system for easier integration of future AI models.
74 lines
3.4 KiB
Markdown
74 lines
3.4 KiB
Markdown
# Ring for OpenCode
|
|
|
|
OpenCode platform integration for the Ring skills library. This directory contains the runtime plugin and installer that brings Ring's skills, agents, and commands to [OpenCode](https://github.com/ohmyopencode/opencode).
|
|
|
|
## Architecture
|
|
|
|
```
|
|
platforms/opencode/
|
|
├── installer.sh # Installer script (reads from Ring monorepo)
|
|
├── plugin/ # TypeScript runtime plugin (RingUnifiedPlugin)
|
|
│ ├── config/ # Configuration handler and schema
|
|
│ ├── hooks/ # Session-start, context-injection hooks
|
|
│ ├── lifecycle/ # Event routing
|
|
│ ├── loaders/ # Agent, skill, command loaders
|
|
│ ├── tools/ # Custom Ring tools
|
|
│ └── utils/ # State management
|
|
├── prompts/ # Prompt templates (session-start, context-injection)
|
|
├── standards/ # Coding standards (from dev-team/docs/standards/)
|
|
├── templates/ # Project templates
|
|
├── src/ # CLI (doctor, config-manager)
|
|
├── ring.jsonc # Default Ring configuration
|
|
└── ring-config.schema.json # JSON schema for ring.jsonc
|
|
```
|
|
|
|
## How It Works
|
|
|
|
The installer reads skills, agents, and commands directly from the Ring monorepo's canonical directories (`default/`, `dev-team/`, `pm-team/`, etc.) and applies transformations for OpenCode compatibility:
|
|
|
|
1. **Agent transform**: `type` → `mode`, strip unsupported frontmatter (version, output_schema), normalize tool names
|
|
2. **Skill transform**: Keep `name` and `description` in frontmatter, normalize tool references in body
|
|
3. **Command transform**: Strip `argument-hint` (unsupported), normalize tool references
|
|
4. **Hooks**: Not installed (OpenCode uses plugin-based hooks incompatible with Ring's file-based hooks)
|
|
|
|
After transformation, files are installed to `~/.config/opencode/`:
|
|
- `agent/*.md` — Agents (35 from 6 Ring plugins)
|
|
- `skill/*/SKILL.md` — Skills (86 from 6 Ring plugins)
|
|
- `command/*.md` — Commands (33 from 6 Ring plugins)
|
|
- `skill/shared-patterns/*.md` — Shared patterns (merged from all plugins)
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# From the Ring monorepo root:
|
|
./platforms/opencode/installer.sh
|
|
|
|
# Or with custom config dir:
|
|
OPENCODE_CONFIG_DIR=~/.config/opencode ./platforms/opencode/installer.sh
|
|
```
|
|
|
|
## Configuration
|
|
|
|
User config lives at `~/.config/opencode/ring/config.jsonc`. Use it to disable specific agents, skills, commands, or hooks:
|
|
|
|
```jsonc
|
|
{
|
|
"disabled_agents": ["finops-analyzer"],
|
|
"disabled_skills": ["regulatory-templates"],
|
|
"disabled_commands": []
|
|
}
|
|
```
|
|
|
|
## Key Differences from Claude Code
|
|
|
|
| Feature | Claude Code | OpenCode |
|
|
|---------|------------|----------|
|
|
| Directory names | Plural (`agents/`, `skills/`) | Singular (`agent/`, `skill/`) |
|
|
| Tool names | Capitalized (`Bash`, `Read`) | Lowercase (`bash`, `read`) |
|
|
| Hooks | File-based (JSON + scripts) | Plugin-based (TypeScript) |
|
|
| Agent type field | `type: reviewer` | `mode: subagent` |
|
|
| Argument hints | `argument-hint: "[files]"` | Not supported |
|
|
|
|
## Previously: ring-for-opencode
|
|
|
|
This was previously a separate repository (`LerianStudio/ring-for-opencode`). It was consolidated into the Ring monorepo to eliminate content drift and sync overhead. The runtime plugin and installer are maintained here; skills, agents, and commands come from the Ring monorepo's canonical sources.
|