92efc4a648
* Add ponytail-audit skill Whole-codebase audit for over-engineering. Scans a repository and produces a ranked report of things to delete, simplify, or replace with stdlib/native equivalents. * Drop counting-by-number heuristics: remove Phase 5 (structural audit) and TODO-age heuristic per review * feat: slim ponytail-audit and add cross-platform parity Rewrite the ponytail-audit skill to ponytail-review's lean shape (35 lines, was 111): same five tags, repo-wide scope, ranked output. Drop the prescriptive phase walkthrough, sampling rules, report template, and the license frontmatter that no other skill carries. Add the adapters the skill was missing so it ships on every supported platform the way ponytail-review does: - commands/ponytail-audit.toml - .opencode/command/ponytail-audit.md - pi-extension registerCommand (+ test) - agent-portability and README entries Co-authored-by: Alexander Brandt <github@a13x.de> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Emeriko <dietrich.gebert@gmail.com> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
34 lines
1.9 KiB
Markdown
34 lines
1.9 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. |
|
|
| 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
|