Ben YounesandClaude Opus 4.8
e01aa900f7
* feat: add Gemini CLI support Add a thin Gemini CLI extension adapter (closes #22). The manifest points contextFileName at the existing AGENTS.md for always-on rules and reuses the repo's commands/*.toml (/ponytail, /ponytail-review) and skills/, which Gemini CLI auto-discovers — no rule text is duplicated. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * test: read manifest inside cases for a clean RED The manifest was parsed at module scope, so reverting the adapter crashed the whole test file at load (ENOENT) and collapsed all four cases into one unreadable failure. Read it inside each case via a helper that asserts existence first, so a missing or malformed manifest surfaces as clear per-case assertion failures instead of a stack trace. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
35 lines
2.1 KiB
Markdown
35 lines
2.1 KiB
Markdown
# Agent Portability
|
|
|
|
Ponytail is an agent-portable skill distribution. The skills in `skills/` hold
|
|
the core behavior; host-specific files are adapters that make that behavior easy
|
|
to load in a given agent.
|
|
|
|
## Supported Adapters
|
|
|
|
| Host | Files | Notes |
|
|
|------|-------|-------|
|
|
| Claude Code | `.claude-plugin/`, `commands/`, `hooks/` | Full plugin install with session activation, mode tracking, commands, and statusline support. |
|
|
| Codex | `.codex-plugin/plugin.json`, `hooks/hooks.json`, `hooks/`, `skills/` | Plugin install with the same skills plus lifecycle hooks for activation and mode tracking. |
|
|
| OpenCode | `.opencode/plugins/ponytail.mjs`, `.opencode/command/`, `hooks/`, `skills/` | Server plugin injects the ruleset each turn via `experimental.chat.system.transform` and persists `/ponytail` switches; reuses the shared instruction builder. |
|
|
| Gemini CLI | `gemini-extension.json`, `AGENTS.md`, `commands/`, `skills/` | Extension manifest points `contextFileName` at `AGENTS.md` for always-on rules, and reuses the existing `commands/*.toml` (`/ponytail`, `/ponytail-review`) and `skills/`, which Gemini CLI auto-discovers. |
|
|
| Cursor | `.cursor/rules/ponytail.mdc` | Always-on project rule. |
|
|
| Windsurf | `.windsurf/rules/ponytail.md` | Project rule. |
|
|
| Cline | `.clinerules/ponytail.md` | Project rule. |
|
|
| GitHub Copilot | `.github/copilot-instructions.md` | Repository instruction file. |
|
|
| Kiro | `.kiro/steering/ponytail.md` | Steering rule; copy globally or into a project. |
|
|
| Generic agents | `AGENTS.md` or `skills/*/SKILL.md` | Copy the compact rule file or load the skill files directly. |
|
|
|
|
## Adapter Rule
|
|
|
|
Keep adapters thin. When a host supports skills or hooks, point it at the
|
|
existing `skills/` and `hooks/` files. When a host only supports project
|
|
instructions, keep its copied rule text aligned with `AGENTS.md`.
|
|
|
|
## Portable Behavior
|
|
|
|
- `skills/ponytail/SKILL.md`: lazy senior dev mode
|
|
- `skills/ponytail-review/SKILL.md`: over-engineering review
|
|
- `skills/ponytail-audit/SKILL.md`: whole-repo over-engineering audit
|
|
- `skills/ponytail-help/SKILL.md`: quick reference
|
|
- `AGENTS.md`: compact always-on instruction set for agents without skill support
|