EvolveHQ/docflow

brainstorm

Convierte un problema difuso en un conjunto estructurado de ADRs candidatos y elementos del plan. Este skill es solo generativo y de lectura/propuesta — nunca escribe ADRs ni archivos de plan directamente. Tras la aprobación, pasa cada candidato a los skills new-adr y new-plan.

Paso 0 — Precondiciones y contexto

1. Confirma que el repositorio está inicializado (o señala que la salida puede servir de base para una ejecución nueva del skill bootstrap).
2. Lee CONVENTIONS.md para conocer la forma y el ciclo de vida de los ADRs, y hojea INDEX.md + los ADRs existentes para que los candidatos no dupliquen ni contradigan lo que ya existe, y para que las dependencias apunten a ADRs reales.

Paso 0.5 — Evaluación (ejecutar primero)

Ejecuta el protocolo de evaluación compartido antes de descomponer:

• Reutiliza primero las respuestas proporcionadas. Trata las opciones aplicables ya suministradas en la solicitud o en esta sesión, incluida la profundidad, como respondidas. Resúmelas sin preguntar de nuevo; los valores predeterminados nunca reemplazan opciones explícitas. Si se han proporcionado todas las opciones pertinentes, continúa. Pregunta solo sobre una opción pertinente que falte o sea conflictiva. Una preferencia del repositorio por sí sola no es una respuesta actual ni una autorización de ejecución.

• Selector de profundidad para opciones no resueltas. Si no se ha proporcionado la profundidad y quedan opciones, pregunta hasta qué profundidad debe llegar esta evaluación: expresa — cada opción toma su valor predeterminado recomendado; solo se siguen haciendo las preguntas sin un valor predeterminado derivable (lo esencial de texto libre); guiada — solo las preguntas marcadas como de alto impacto a continuación, más lo esencial de texto libre; completa — todas las preguntas a continuación. Si el archivo CONVENTIONS.md del repositorio registra una Profundidad de evaluación:, preselecciónala como la opción recomendada al preguntar; una profundidad registrada nunca se aplica en silencio. De lo contrario, recomienda completa cuando la solicitud llegó con poco o ningún contexto y expresa cuando ya está completamente especificada. En cualquier pregunta, el operador puede responder "valores predeterminados desde aquí" o "ir más allá"; respeta el cambio de inmediato.

• Haz las preguntas a continuación una a una, cada una con una opción recomendada y una razón de una línea; espera cada respuesta.

• Usa selección estructurada (de opción única o múltiple). Si el host expone una herramienta de pregunta estructurada de selección única/múltiple, úsala y marca la opción recomendada; de lo contrario, enumera las opciones A/B/C en texto plano y nombra la recomendada. Usa solo texto libre donde un conjunto enumerable sea imposible (por ejemplo, el enunciado del objetivo).

• El operador decide. Nunca continúes más allá de una pregunta sin una respuesta, y nunca adivines el alcance cuando se te invoque sin contexto.

Preguntas (omite cualquier que la solicitud ya responda):

1. Objetivo / problema — texto libre (la respuesta abierta inevitable; se pregunta en todas las profundidades) si no se ha dado ya.
2. Salida — solo ADRs candidatos, o ADRs + elementos del plan. Recomendado: ADRs + elementos del plan.
3. Profundidad de descomposición — rápida (principales candidatos) o exhaustiva (descomposición completa). Recomendado: primero rápida, ampliar bajo petición.

Ninguna pregunta aquí está marcada como de alto impacto: una ejecución guiada se comporta como la expresa para este skill.

Este skill no escribe nada hasta que apruebes el esquema.

Paso 1 — Comprender el problema

Pregunta por el objetivo/característica/problema si no se ha dado. Indaga sobre los límites del alcance, las restricciones y las preocupaciones regulatorias/de calidad que sean relevantes para este repositorio. No empieces a descomponer hasta que el objetivo esté claro.

Paso 2 — Descomponer

Genera una lista de candidatos. Para cada ADR candidato:

• Número propuesto (el siguiente disponible, consecutivo), título provisional, forma (capacidad vs. tecnología si el repositorio los separa).
• Alcance de una línea: la decisión única que captura.
• Dependencias de otros candidatos o ADRs existentes.

Una decisión por ADR. Si un candidato agrupa varias decisiones, divídelo y explica por qué. Si un candidato es en realidad un ADR existente que necesita revisión, dilo en lugar de proponer un número nuevo.

Paso 3 — Ordenar el trabajo

Propón un orden del plan (qué elementos de plan/todo/, en qué secuencia) respetando las aristas de dependencia. Señala dónde se puede paralelizar el trabajo (información útil para el skill agent-wave).

Paso 4 — Revisar y entregar

Presenta el conjunto completo como un esquema revisable (candidatos + dependencias

• ordenamiento). Acepta ediciones. No escribas nada todavía. Una vez que el usuario lo apruebe, créalos invocando el skill new-adr por cada candidato y el skill new-plan por cada elemento en cola — o entrega el esquema aprobado a esos skills.

Barrera de seguridad: si el problema es demasiado vago para descomponerlo sin inventar requisitos, dilo y pide más información, en lugar de producir ADRs especulativos.

Nombra las opciones acordadas y las decisiones pendientes; la discusión por sí sola no crea artefactos.

Informe de cierre

Finaliza cada ejecución, incluidas las ejecuciones bloqueadas, fallidas y detenidas, con una sección encabezada exactamente como Estado de un vistazo, que contenga estas tres etiquetas:

• Esta ejecución: solo las acciones realmente intentadas y sus resultados; cita la salida exacta y el código de salida de cada punto de verificación, incluidos los tiempos de espera o las interrupciones.
• En general: implementado, parcialmente verificado, verificado, bloqueado, fallido o desconocido. Un subpaso exitoso no es un éxito general; la evidencia incompleta o faltante nunca se convierte en éxito.
• Pendiente: cada acción restante, hallazgo no resuelto, verificación, limpieza o entrada requerida. Escribe "Ninguno" solo cuando toda la tarea esté verificablemente completa; nunca omitas trabajo porque se haya agotado un presupuesto.

Los mensajes de progreso rutinarios no necesitan bloque. Mantén los resultados finales breves y distingue el trabajo preparado en un PR del trabajo confirmado como enviado.