ponytail

Ponytail é uma skill, plugin e conjunto de regras para agentes de codificação de IA, projetado para levá-los a escrever menos código e mais simples. Seu slogan é o "lazy senior dev": em vez de gerar um componente wrapper, uma folha de estilos e uma dependência para algo como um seletor de data, o agente é orientado a usar um input HTML nativo existente (`<input type="date">`) quando isso é tudo o que a tarefa precisa. ## Como funciona Antes de escrever código, o agente percorre uma escada e para no primeiro degrau que se sustenta: 1. Isso precisa existir? Se não, pule (YAGNI). 2. Já existe neste código? Reutilize, não reescreva. 3. A stdlib faz isso? Use. 4. Recurso nativo da plataforma? Use. 5. Dependência instalada? Use. 6. Uma linha? Escreva uma linha. 7. Só então: o mínimo que funciona. O projeto enfatiza que a escada roda depois que o agente entende o problema, não em vez disso: o agente ainda deve ler o código e traçar o fluxo real. Também destaca que "preguiçoso" não é "negligente": validação, tratamento de erros, segurança e acessibilidade nunca são sacrificados. ## Alegações de benchmark O README relata um benchmark agêntico usando uma sessão headless do Claude Code editando um template real de FastAPI + React, pontuado pelo git diff em doze tarefas de funcionalidade (Haiku 4.5, n=4). Ele afirma que o ponytail reduziu LOC em ~54% (até 94% em casos de over-build) enquanto também reduzia tokens, custo e tempo, e permanecia em 100% em uma camada de segurança. Inclui números mais antigos de single-shot mostrando 80-94% menos código, com a ressalva de que parte dessa diferença veio de um artefato de baseline conversacional. O projeto linka para writeups completos e instruções de reprodução em vez de apresentar os números como a única evidência. ## Instalação e suporte Ponytail instala como plugin ou conjunto de regras em uma ampla variedade de hosts de codificação de IA, incluindo: - Claude Code e Codex via comandos de plugin marketplace - GitHub Copilot CLI via plugin install - Gemini CLI e Antigravity CLI via extension install - OpenCode via uma entrada de plugin em `opencode.json` - Pi, Hermes Agent, Devin CLI, OpenClaw, Grok Build e Qoder via seus próprios mecanismos de pacote - Cursor, Windsurf, Cline, Kiro, Zed, CodeWhale, Swival e outros copiando um arquivo de regras como `AGENTS.md` ou o diretório de regras relevante Ele é distribuído como um único repositório com diretórios compartilhados `hooks/` e `skills/` mais adaptadores específicos de agente. ## Comandos Hosts com suporte a skills expõem alguns comandos de barra: - `/ponytail [lite | full | ultra | off]` - define a intensidade ou desliga - `/ponytail-review` - revisa o diff atual em busca de over-engineering e retorna uma lista de exclusão - `/ponytail-audit` - audita todo o repositório em busca de over-engineering - `/ponytail-debt` - coleta atalhos "ponytail:" adiados em um ledger - `/ponytail-gain` - mostra o impacto medido do benchmark - `/ponytail-help` - referência rápida Os níveis podem ser controlados por sessão, por subagente via a variável de ambiente `PONYTAIL_SUBAGENT_MATCHER`, ou por padrão via a variável de ambiente `PONYTAIL_DEFAULT_MODE` ou um pequeno arquivo de configuração. ## Desenvolvimento O repositório inclui scripts para manter o texto compacto de regras em sincronia entre todas as cópias de agentes (`node scripts/check-rule-copies.js`), gerar o pacote de skill do OpenClaw, publicar skills no ClawHub e executar o benchmark de correção (Python é usado para verificações de email e CSV). ## Licença MIT.