Skip to content

agent-portability.md

Latest commit

 

History

History
41 lines (34 loc) · 3.61 KB

agent-portability.md

File metadata and controls

41 lines (34 loc) · 3.61 KB

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/plugin.json, commands/, hooks/claude-codex-hooks.json, hooks/ Full plugin install with session activation, mode tracking, commands, and statusline support.
Codex .codex-plugin/plugin.json, hooks/claude-codex-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.
pi pi-extension/, skills/, hooks/ Package extension: injects the ruleset each turn through the shared instruction builder and registers the /ponytail commands.
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 and skills/, which Gemini CLI auto-discovers. The Claude/Codex hook map is not placed at Gemini's auto-discovered hooks/hooks.json path.
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.
GitHub Copilot CLI .github/plugin/, AGENTS.md, .github/copilot-instructions.md, ~/.copilot/copilot-instructions.md Plugin-supported (copilot plugin marketplace add DietrichGebert/ponytail + copilot plugin install ponytail@ponytail). Fallback instruction mode remains: per-project from AGENTS.md or .github/copilot-instructions.md, or globally from ~/.copilot/copilot-instructions.md (instruction-tier, no /ponytail levels or hooks).
Antigravity AGENTS.md Reads AGENTS.md at the repo root as always-on rules (like .cursorrules/CLAUDE.md); .agents/rules/ also works for workspace rules. Instruction-tier.
CodeWhale AGENTS.md Reads AGENTS.md from the repo root as project instructions; also reads CLAUDE.md and .claude/instructions.md as fallbacks. Instruction-tier.
VS Code + Codex extension AGENTS.md The Codex extension reads AGENTS.md (repo root, or ~/.codex/AGENTS.md globally). Instruction-tier; the full Codex plugin row above adds /ponytail levels and hooks.
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-debt/SKILL.md: harvest ponytail: shortcuts into a tracked ledger
  • skills/ponytail-gain/SKILL.md: measured-impact scoreboard from the benchmark
  • skills/ponytail-help/SKILL.md: quick reference
  • AGENTS.md: compact always-on instruction set for agents without skill support