Lev-it/lev-skills

Pregunta 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.

El flujo principal: idea → publicación

La ruta que recorre la mayor parte del trabajo. Tienes una idea y quieres construirla.

1. /grill-with-docs — afila la idea mediante una entrevista. Empieza aquí cuando tienes un código base: es stateful, conservando lo que aprende en CONTEXT.md y ADRs. (¿No hay código base? Usa /grill-me — consulta Independientes).
2. Rama: ¿puedes resolver cada pregunta en la conversación? Si una pregunta necesita una respuesta ejecutable (estado, lógica de negocio, una UI que tienes que ver), desvía a través de un prototipo, puenteado por /handoff en ambas direcciones (consulta Sesiones cruzadas):
   • /handoff hacia afuera, luego abre una sesión nueva contra ese archivo,
   • /prototype para responder la pregunta con código desechable,
   • /handoff de vuelta lo que aprendiste, y referéncialo desde el hilo de la idea original.
3. Rama: ¿es una construcción multi-sesión?
   • Sí → /to-prd (convierte el hilo en un PRD) → /to-issues (divide el PRD en issues que se pueden tomar de forma independiente). Como los issues son independientes, limpia el contexto entre cada uno: inicia una sesión nueva por issue y arranca /implement pasándole el PRD y el issue único en el que trabajar.
   • No → /implement aquí mismo, en la misma ventana de contexto.

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 entonces comienza fresco, trabajando desde el issue.

El límite es la zona inteligente: la ventana (~120k tokens en modelos de última generación) dentro de la cual el modelo aún razona de forma aguda. Si una sesión se aproxima a ella antes de /to-issues, no insistas con degradación — 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.

• Los bugs y solicitudes se acumulan → /triage. Mueve los issues a través de roles de triaje y produce issues listos para el agente, que /implement recoge más tarde.

  El triaje es solo para issues que no creaste tú — reportes de bugs, solicitudes de funcionalidades entrantes, cualquier cosa que llegue en bruto. Los issues que /to-issues produce ya están listos para el agente, así que no los triajes.

Salud del código base

No es trabajo de funcionalidades — es mantenimiento.

• /improve-codebase-architecture — ejecútalo cuando tengas un momento libre para mantener el código base en buen estado para que los agentes operen. Revela oportunidades de profundización; elegir una genera una idea que puedes llevar al flujo principal en /grill-with-docs.

Sesiones cruzadas

• /handoff — cuando un hilo está lleno o necesitas bifurcarte (por ejemplo, hacia 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 referencias 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 la conversación actual preservada.
• /compact (incorporado) — permanece en la misma conversación, permitiendo que las primeras vueltas se resuman. Úsalo en pausas intencionales entre fases, cuando no te importe perder el historial textual. No compactes en medio de una fase — el agente podría perderse. /handoff bifurca; /compact continúa.

Independientes

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 construye CONTEXT.md. Recurre a él para afilar cualquier plan o diseño que no viva en un repositorio.
• /teach — aprende un concepto a través de múltiples sesiones, usando el directorio actual como un espacio de trabajo con estado.
• /writing-great-skills — referencia para escribir y editar skills correctamente.

Precondición

/setup-matt-pocock-skills — ejecútalo antes de tu primer flujo de ingeniería para configurar el rastreador de issues, las etiquetas de triaje y el diseño de documentos que los otros skills asumen. Los rastreadores de issues personalizados también funcionan.