Skip to content

Latest commit

 

History

History
208 lines (146 loc) · 13.5 KB

README.es.md

File metadata and controls

208 lines (146 loc) · 13.5 KB

Ponytail, el senior dev perezoso

Ponytail

No dice nada. Escribe una línea. Funciona.

DietrichGebert%2Fponytail | Trendshift

Stars Release npm Works with 20 agents MIT license

DietrichGebert/ponytail | Trendshift DietrichGebert/ponytail | Trendshift DietrichGebert%2Fponytail | Trendshift monthly ranking

Ponytail 5, reconstruido desde cero: -53% código, -41% tiempo, -26% coste, -45% tokens. Y aun así el 98% de la lógica arriesgada sale con un test; sin Ponytail, el 68%.

Ponytail 5: reconstruido desde cero.
-53% código · -41% tiempo · -26% coste · -45% tokens
Y aun así: el 98% de la lógica arriesgada sale con un test. Sin Ponytail: 68%.
Medido en Claude Code, el mismo agente con y sin el skill: 39 tareas, entre ellas un repo real de FastAPI + React, Opus 5.5, 5 ejecuciones cada una. Detalles.

English · Español · 한국어 · 简体中文 · 日本語
Traducción del README en inglés. Si algo no coincide, vale la versión en inglés.


Algo se acerca, únete a la lista de espera

Ya construido con Ponytail

Retriever

Ya lo conoces. Coleta larga. Gafas ovaladas. Lleva en la empresa más tiempo que el control de versiones. Le enseñas cincuenta líneas; las mira, no dice nada y las cambia por una.

Ponytail lo mete dentro de tu agente de IA.

Números

Porcentaje del baseline sin skill. Líneas de código: Ponytail v4.13 52%, Ponytail 5 47%. Tokens de salida: 57% y 55%. Coste: 84% y 74%. Tiempo: 62% y 59%.

La mitad del código, y aun así mejor: el 98% de la lógica arriesgada sale con un test (sin skill 68%); los propios tests del agente detectan el 66% de los bugs inyectados (sin skill 46%).

Dos cosas que el gráfico no muestra: en una comparación a ciegas, las respuestas de Ponytail 5 ganan a las del Ponytail anterior por 110 a 67. Y en las seis tareas de seguridad (inyección SQL, path traversal, tokens falsificados, limitación de peticiones, filas CSV mal formadas, caché) pasó las 30 ejecuciones: menos código, igual de seguro. Método, tablas por tarea y limitaciones: benchmarks/results/2026-10-07-agentic.md.

La regla nunca fue "la menor cantidad de tokens". Es: escribe solo lo que la tarea necesita, y nunca recortes validación, manejo de errores, seguridad ni accesibilidad. El código acaba siendo pequeño porque es lo necesario, no porque esté comprimido a la fuerza. El menor coste y la menor latencia son un efecto secundario.

Antes / después

Añade un selector de fechas al frontend. Sin skill: 335 líneas, un calendario y un selector de fechas hechos a mano. Ponytail 5: un archivo de 10 líneas que reutiliza el Input del repo con type date, y el navegador pone el calendario.

Pides un selector de fechas. Sin Ponytail, el agente instala una librería de selector de fechas o construye un calendario entero a mano: 335 líneas. Ponytail 5 primero mira lo que ya hay: el repo tiene un componente Input, y todos los navegadores traen un selector de fechas. Junta las dos cosas. 10 líneas.

Más supervivientes en examples/.

La revisión, reconstruida

La revisión, reconstruida. Un hallazgo real de /ponytail-review en el benchmark: el cambio renombró un campo, y un archivo que nadie tocó, src/routes/feed.js, ahora se cae. Hay que arreglarlo: el feed Atom ahora se cae en cada petición, con qué es esto, el problema, el arreglo y qué pasa si no se arregla. Encuentra el 100% de los problemas plantados, sin skill el 87%. Encuentra el 100% de los problemas fuera del diff, sin skill el 78%.

/ponytail-review antes solo buscaba código que recortar. Ahora revisa como el dev senior al que llaman cuando algo se rompe: lee el código que toca tu cambio, no solo el diff, y revisa bugs, seguridad, carga real, tests que faltan, velocidad y lo que sobra. Cada hallazgo dice qué hace el código, qué falla, cómo arreglarlo y qué pasa si no lo arreglas.

La auditoría, reconstruida

Todo tu repo, por orden de prioridad. Arregla esto primero. Un /ponytail-audit real del benchmark sobre un repo de stock de almacén: 1 hay que arreglarlo, los lotes de oficina de 1200 fallan por completo; 2 hay que arreglarlo, la importación se salta en silencio las filas erróneas; 3 hay que arreglarlo, un SKU mal escrito en un lote de oficina se ignora en silencio; 4 conviene arreglarlo, las partes arriesgadas del código no tienen tests; 5 estaría bien, la API se cae con un body que no es un objeto. Veredicto: arregla primero el 1.

/ponytail-audit hace las mismas comprobaciones en todo el repo. Primero hace un mapa del código: puntos de entrada, cómo se mueven los datos, qué carga espera el proyecto. Después ordena lo que encuentra por prioridad y te dice qué arreglar primero. La auditoría anterior solo listaba lo que había que borrar.

Cómo funciona

Antes de escribir código, detente en el primer peldaño que se sostiene: 1 ¿hace falta que exista?, 2 ¿ya está en este código?, 3 ¿lo hace la librería estándar?, 4 una función nativa de la plataforma, 5 una dependencia instalada, 6 ¿puede ser una línea?, 7 solo entonces lo mínimo que funcione, más un test pequeño si tiene lógica.

La escalera corre después de entender el problema, no en su lugar: lee el código que toca el cambio y sigue el flujo real antes de elegir un peldaño. Perezoso con la solución, nunca con la lectura.

Perezoso, no negligente: la validación en los límites de confianza, el manejo de pérdida de datos, la seguridad y la accesibilidad nunca se recortan.

La lógica con una rama, un bucle, un parser, dinero o seguridad deja un test pequeño. Cada respuesta termina con lo que se saltó o no se comprobó y cualquier riesgo que debas conocer.

El prompt

Ponytail es un solo prompt: skills/ponytail/SKILL.md. La versión compacta, para agentes que leen un archivo de reglas, es AGENTS.md. Todo lo demás en este repo sirve para cargar ese prompt en distintos agentes.

Instalación

Claude Code, como dos prompts separados:

/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail

Codex:

codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail

Después abre /hooks en Codex, confía en sus dos hooks de ciclo de vida y empieza un hilo nuevo.

Cualquier otro agente: copia AGENTS.md en tu proyecto, o pídele a tu agente que instale skills/ponytail/SKILL.md como skill. Paso a paso para Copilot, Cursor, OpenCode, Gemini y el resto (en inglés): INSTALL.md.

Eso era todo. Estaría orgulloso. No lo va a decir.

Activo en cada sesión, con un puñado de comandos (ver Comandos). /ponytail ultra existe para cuando el código te ha ofendido personalmente. El texto de inicio y de cambio de modo muestra el modo actual.

Instala ponytail solo desde DietrichGebert/ponytail en GitHub o @dietrichgebert/ponytail en npm. Nunca incluye archivos .exe ni .dll; una copia que los incluya no es mía.

Comandos

Comando Qué hace
/ponytail [lite | full | ultra | off] Ajusta la intensidad o lo apaga. Sin argumento enciende ponytail en el nivel por defecto si está apagado; si no, muestra el nivel actual.
/ponytail-review Revisa el diff actual como el dev senior al que llaman cuando algo se rompe: bugs, seguridad, carga real, código arriesgado sin test, partes lentas y lo que sobra. Cada hallazgo dice qué hace el código, qué falla, cómo arreglarlo y qué pasa si no se arregla. Indica un objetivo con palabras normales para acotarlo o ampliarlo: uncommitted, staged, branch o un enlace a un PR.
/ponytail-audit La misma revisión para todo el repo, lo más importante primero.
/ponytail-debt Reúne los atajos shortcut: que dejaste para después en un registro, para que "luego" no se convierta en "nunca".
/ponytail-gain Muestra el marcador de impacto medido (menos código, menos coste, más velocidad) del benchmark.
/ponytail-help Referencia rápida de los comandos anteriores.

Los comandos necesitan un host con soporte de skills (Claude Code, Codex, Devin CLI, OpenCode, Gemini, Antigravity CLI, pi, Hermes Agent, Qoder, Grok Build). En Codex CLI y en la extensión del IDE son skills dentro del espacio de nombres del plugin; se invocan con $ponytail:ponytail-review. Cursor con los hooks solo tiene el cambio de nivel con /ponytail, escrito como mensaje normal. Los adaptadores de solo instrucciones (el archivo de reglas de Cursor, Windsurf, Cline, Copilot, Kiro, el modo alternativo de Antigravity con AGENTS.md) cargan las reglas siempre activas, sin los comandos.

Preguntas frecuentes

¿Necesita un archivo de configuración? No. Un ~/.config/ponytail/config.json opcional o la variable de entorno PONYTAIL_DEFAULT_MODE pueden fijar el nivel por defecto, pero no hace falta nada.

¿Por qué escribe comentarios shortcut:? Marcan un atajo deliberado y cuándo revisarlo, y /ponytail-debt los reúne en un registro. ¿Quieres otra palabra, o ninguna? Dilo en el CLAUDE.md o AGENTS.md de tu proyecto y luego ejecuta /ponytail-debt <tu palabra>.

¿Y si de verdad necesito la clase de caché de 120 líneas? No la necesitas. Insiste de todos modos y te la construye. Despacio. Correctamente. Mirándote.

¿Escala? El código que nunca escribiste escala hasta el infinito. Cero bugs, cero CVEs, 100% de disponibilidad desde siempre.

¿Por qué "ponytail"? Sabes perfectamente por qué.

Patrocinadores

GreenPT

Licencia

MIT. La licencia más corta que funciona.

Historial de estrellas

Star History Chart