triage
Skill0 starsChanged 42 days agoMITView on GitHub
Bug report where the right move is unclear, especially after failed fixes: \"otra vez el mismo bug\", \"no se puede arreglar\", \"este proyecto es basura\". Read-only diagnosis, verdict, next skill.
Files
Triage — ¿fix, refactor, agent-debug o rebuild?
Overview
Decide QUÉ tipo de intervención necesita el proyecto ANTES de tocar código. El error más caro no es un mal fix: es aplicar la herramienta equivocada — parchar lo que necesita reestructura, o reescribir lo que necesitaba un cambio de una línea.
Regla de hierro: cero ediciones de código durante el triage. Solo lectura, métricas y veredicto.
Cuándo usar
- Reporte de bug en un proyecto que no conoces o que ya falló antes.
- El mismo síntoma ya se "arregló" 2+ veces y volvió.
- Archivos gigantes, sin tests, historial de fixes que rompen otras cosas.
- Duda entre arreglar y rehacer.
Cuándo NO usar
| Situación | Ruta |
| Diagnóstico claro y ruta evidente | invoca directo la skill correspondiente |
| No arranca por entorno | env-doctor |
| Pregunta teórica sin proyecto | consulta |
| Pedido nuevo, no un bug | intake |
Proceso (30 minutos máximo, solo lectura)
- Memoria del proyecto primero:
AGENTS.md,docs/project/state.md,bugs.md,gotchas.md(o la bóveda de notas si el proyecto usa una). El historial de bugs es la mejor evidencia de repetición. - Medir el repo, no opinar:
- Tamaño de los archivos principales (monolito = un archivo > 1.500 líneas).
- ¿Hay tests que se puedan ejecutar? ¿Pasan hoy?
- Cobertura aproximada y complejidad máxima si hay herramienta.
git logde los últimos 20-30 commits: cuántos son "fix" sobre el mismo archivo o el mismo síntoma.- Cruce churn × complejidad: qué archivo concentra los cambios recientes.
- ¿Existe constitución/gate? ¿Corre?
- Clasificar el síntoma: ¿error puntual con traza? ¿comportamiento errático de un agente IA? ¿visual? ¿funciona pero da miedo tocarlo? ¿no arranca?
- Veredicto con la tabla.
Tabla de ruteo
| Evidencia dominante | Ruta |
| Error puntual, causa localizable, proyecto estructuralmente sano | fixer |
| Bot/agente IA decide mal: flujo, estado, prompt, clasificadores, herramientas | agent-debug |
| Síntoma visual, de maquetación o de interacción | ui-bug |
| Funciona, pero cada cambio rompe otra cosa; monolito; miedo a tocar | refactor (antes: test-strategy para la red) |
| Sin tests + sin estructura + efectos cruzados + la arquitectura ya no soporta lo pedido + repetición documentada de fixes | rebuild |
| No arranca / entorno roto | env-doctor |
| Lento pero correcto | performance |
| Falla en producción y nadie se entera | observability |
| Deuda difusa, hay que priorizar antes de intervenir | tech-debt |
| 2+ intentos de fix fallidos sobre el MISMO síntoma | prohibido volver a fixer — elegir entre agent-debug, refactor o rebuild según lo de arriba |
Señales combinadas: monolito + comportamiento raro de IA → agent-debug primero (encontrar la capa real), refactor después como prevención. El fix inmediato y la deuda estructural son dos entregables distintos: nombra los dos.
Lo que el triage también debe detectar
- No hay gate ni umbrales → la falta de verificación es parte del diagnóstico:
constitution. - No hay notas del proyecto → cada sesión re-explora y repite errores:
project-memory. - No hay tests ejecutables → cualquier intervención es a ciegas:
test-strategyantes que nada. - El proyecto no tiene dueño claro de la decisión → decir quién tiene que decidir y qué.
Anti-racionalización
| Excusa | Realidad |
| "Es solo una línea, la arreglo de una" | Si el síntoma ya reapareció antes, la línea no es la causa. |
| "Triage es burocracia" | 30 minutos de lectura contra días de ciclo fix → rompe → fix. |
| "Rebuild es admitir derrota" | La mayoría de los rewrites cuestan mucho más de lo previsto; pero parchar un proyecto inmantenible también es tirar plata. El veredicto honesto gana en ambas direcciones. |
| "No hay notas de este proyecto" | Entonces el triage incluye recomendar crearlas: la falta de memoria escrita es parte del diagnóstico. |
| "Miré el código y me parece que..." | Sin métricas, "me parece" es gusto. Cuenta líneas, corre git log, mide. |
Formato de salida
- Veredicto: skill a invocar (una principal, opcional una secundaria como deuda).
- Evidencia: 3-5 hechos medidos (líneas, tests, repetición en el historial, bugs recurrentes).
- Qué NO hacer: la ruta descartada y por qué.
- Faltantes estructurales: gate, tests o notas que no existen.
- Si falta información para decidir: decirlo y pedir exactamente qué (log, captura, conversación real). No adivinar.
Other versions191 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 191
- mattpocock/skills★ 309ksame name
- withastro/astro★ 64ksame name
- vectorize-io/hindsight★ 57ksame name
- ogulcancelik/herdr★ 47ksame name
- herdrdev/herdr★ 47ksame name
- colinhacks/zod★ 44ksame name
- QuivrHQ/quivr★ 40ksame name
- vercel-labs/skills★ 37ksame name
- pnpm/pnpm★ 37ksame name
- vercel-labs/add-skill★ 35ksame name
181 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use writing-beats, setup-matt-pocock-skills and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
LesaniSkillwriting-beats
Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.
Also in 61 projects that use this
GoogleSkillsetup-matt-pocock-skills
Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
Also in 159 projects that use this
SethGammonSkillascii-diagram
Generate perfectly aligned ASCII diagrams — architecture, flow, sequence, box-and-arrow. Uses a programmatic character-grid approach so alignment is guaranteed by math, not token prediction. Includes post-render verification.
Also in 4 projects that use this
liufeng1976Skillsetup-ts-deep-modules
Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.
Also in 37 projects that use this
simo97Skillmigrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
Also in 64 projects that use this
FabienDehopreSkilldecision-mapping
Turn a loose idea into a sequenced map of investigation tickets, then drive them to resolution one at a time.
Also in 7 projects that use this
In this repository37 other files it gives its agents.
- skills/constitution/templates/AGENTS.mdAGENTS.md
- agent-debugSkill
- agentic-codingSkill
- ai-securitySkill
- api-backendSkill
- app-securitySkill
- architectureSkill
- automationSkill
- batchSkill
- bot-devSkill
- changelog-generatorSkill
- code-standardSkill
- constitutionSkill
- consultaSkill
- data-layerSkill
- deploySkill
- desktop-appSkill
- dev-routerSkill
- diff-reviewSkill
- env-doctorSkill
- featureSkill
- fixerSkill
- intakeSkill
- mobile-appSkill
- observabilitySkill
- performanceSkill
- project-memorySkill
- quality-gateSkill
- readme-generatorSkill
- rebuildSkill
- refactorSkill
- tech-debtSkill
- test-strategySkill
- ui-bugSkill
- ui-designSkill
- valida-ideaSkill
- web-appSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.