Pregúntale a Matt
No recuerdas todos los skills, así que pregunta.
Un flujo es un camino a través de los skills. La mayoría de los caminos recorren un flujo principal y dos rampas de acceso se fusionan en él. Todo lo demás es independiente, o una capa de vocabulario que se ejecuta por debajo.
El flujo principal: idea → envío
La ruta que recorre la mayor parte del trabajo. Tienes una idea y quieres que se construya.
-
/grill-with-docs— afina la idea mediante una entrevista. Comienza aquí cuando tienes un código base: es stateful, reteniendo lo que aprende enCONTEXT.mdy ADRs. (¿No hay código base? Usa/grill-me— consulta Independiente. Ambos ejecutan el mismo primitivo/grilling;grill-with-docses el que deja un rastro documental). -
Rama — ¿puedes resolver cada pregunta en conversación? Si una pregunta necesita una respuesta ejecutable (estado, lógica de negocio, una interfaz de usuario que debes ver), desvía a través de un prototipo, puenteado por
/handoffen ambas direcciones (consulta Cruzando sesiones):/handoffhacia afuera, luego abre una nueva sesión contra ese archivo,/prototypepara responder la pregunta con código desechable,/handoffde vuelta con lo aprendido, y refiérelo desde el hilo de la idea original.
-
Rama — ¿es esto una construcción de múltiples sesiones?
- Sí →
/to-prd(convierte el hilo en un PRD) →/to-issues(divide el PRD en issues independientemente abordables). Debido a que los issues son independientes, limpia el contexto entre cada uno: inicia una nueva sesión por issue y comienza/implementpasándole el PRD y el único issue en el que trabajar. - No →
/implementaquí mismo, en la misma ventana de contexto.
En cualquier caso,
/implementconstruye cada issue manejando/tddinternamente — una rebanada rojo-verde a la vez — luego finaliza ejecutando/code-review, una revisión de dos ejes (Estándares + Especificación) del diff, antes de hacer commit. Recurre a/tddpor sí solo cuando solo quieres construir un comportamiento concreto con pruebas primero sin una especificación completa, y/code-reviewpor sí solo cada vez que quieras revisar una rama o PR contra un punto fijo. - Sí →
Higiene del contexto
Mantén los pasos 1–3 en una ventana de contexto ininterrumpida — no compactes ni limpies hasta después de /to-issues — para que la entrevista, el PRD y los issues se construyan sobre el mismo pensamiento. Cada /implement luego comienza fresco, trabajando desde el issue.
El límite de esto es la zona inteligente: la ventana (~120k tokens en modelos de última generación) dentro de la cual el modelo aún razona con claridad. Si una sesión se acerca a ella antes de /to-issues, no fuerces en modo degradado — haz /handoff y continúa en un hilo nuevo.
Rampas de acceso
Una situación inicial que genera trabajo y luego se fusiona con el flujo principal.
-
Errores y solicitudes acumulándose →
/triage. Mueve los issues a través de roles de triaje y produce issues listos para el agente, que/implementrecoge más tarde.El triaje es solo para issues que no creaste tú — informes de errores, solicitudes de características entrantes, cualquier cosa que llegue en bruto. Los issues que
/to-issuesprodujo ya están listos para el agente, así que no los triages. -
Algo está roto →
/diagnosing-bugs. Para los difíciles: el error que resiste un primer vistazo, la falla intermitente, la regresión que se coló entre dos estados conocidos como buenos. Se niega a teorizar hasta que tiene un bucle de retroalimentación ajustado — un comando que ya falla con este error — luego corrige con una prueba de regresión. Su análisis post-mortem pasa a/improve-codebase-architecturecuando el hallazgo real es que no hay una buena costura para fijar el error.
Salud del código base
No es trabajo de características — mantenimiento.
/improve-codebase-architecture— ejecuta cada vez que tengas un momento libre para mantener el código base en buen estado para que los agentes operen. Descubre oportunidades de profundización; elegir una genera una idea que puedes llevar al flujo principal en/grill-with-docs. Es el estudio que encuentra los candidatos;/codebase-design(abajo) es el banco donde diseñas el elegido.
Vocabulario subyacente
Dos referencias invocadas por el modelo que se ejecutan debajo de los otros skills — cada una es la fuente única de verdad para su vocabulario. Recurre a ellas directamente cuando las palabras, no el proceso, son el problema; o deja que los skills anteriores las incorporen.
/domain-modeling— afina el lenguaje de dominio del proyecto: cuestiona un término difuso, resuelve una palabra sobrecargada ("cuenta" haciendo tres trabajos), registra una decisión difícil de revertir como un ADR. Es la disciplina activa que/grill-with-docsimpulsa para mantenerCONTEXT.mdcomo un glosario limpio./codebase-design— el vocabulario de módulos profundos (módulo, interfaz, profundidad, costura, adaptador, apalancamiento, localidad) para diseñar la forma de un módulo: mucho comportamiento detrás de una interfaz pequeña en una costura limpia./tddy/improve-codebase-architectureambos lo hablan.
Cruzando sesiones
/handoff— cuando un hilo está lleno o necesitas ramificarte (por ejemplo, en una sesión de/prototype), esto compacta la conversación en un archivo markdown. No continúas en el mismo lugar — abres una nueva sesión y haces referencia a ese archivo para llevar el contexto a través. Es el puente entre ventanas de contexto, en cualquier dirección. Úsalo cuando quieras una sesión nueva pero necesites que la conversación actual se conserve./compact(incorporado) — permanece en la misma conversación, permitiendo que los turnos anteriores sean resumidos. Úsalo en pausas intencionales entre fases, cuando no te importe perder el historial textual. No compactes en medio de una fase — el agente puede perder el rumbo./handoffbifurca;/compactcontinúa.
Independiente
Fuera del flujo principal por completo.
/grill-me— la misma entrevista implacable que/grill-with-docs, pero para cuando no tienes código base. Sin estado: no guarda nada localmente, no construyeCONTEXT.md. Recurre a él para afinar cualquier plan o diseño que no viva en un repositorio./prototype— un programa pequeño y desechable que responde una pregunta de diseño: ¿este modelo de estado se siente correcto, o cómo debería verse esta interfaz de usuario? Desechable desde el día uno — guarda la respuesta, elimina el código. Es el desvío en el paso 2 del flujo principal, pero recurre a él cada vez que una pregunta de diseño sea difícil de resolver en papel./research— delega el trabajo de lectura a un agente de fondo: investiga una pregunta contra fuentes primarias, luego deja un archivo Markdown citado en el repositorio. Sigue trabajando mientras él lee. El archivo que produce es algo para llevar hacia el flujo principal en/grill-with-docs— la investigación alimenta el pensamiento, no lo reemplaza./teach— aprende un concepto a lo largo de múltiples sesiones, usando el directorio actual como un espacio de trabajo con estado./writing-great-skills— referencia para escribir y editar skills de manera efectiva.
Precondición
/setup-matt-pocock-skills — ejecuta antes de tu primer flujo de ingeniería para configurar el rastreador de issues, etiquetas de triaje y diseño de documentos que los otros skills asumen. Los rastreadores de issues personalizados también funcionan.