Prompt Cookbook institucional
Patrones de interacción para audit, discovery, sprint, handoff, trabajo paralelo, Git/Kai, infraestructura, incidentes, QA, deployment y release.
Patrones de interacción para audit, discovery, sprint, handoff, trabajo paralelo, Git/Kai, infraestructura, incidentes, QA, deployment y release.
El Prompt Cookbook institucional no busca frases mágicas. Define patrones para dar a humanos y agentes un contrato de trabajo claro, con contexto, límites, resultado esperado y evidencia.
Patrones de interacción
Los patrones cubren discovery, audit, sprint, handoff, trabajo paralelo, Git, infraestructura, incidentes, QA, deployment y release. El objetivo es que el prompt describa la tarea como trabajo de ingeniería, no como una orden ambigua.
- Objetivo y contexto.
- Scope y Non-Goals.
- Restricciones y autoridad.
- Evidence y Definition of Done.
Prompts que reducen riesgo
En tareas sensibles se pide auditar antes de cambiar, separar hechos de inferencias y detenerse ante información faltante. Para merges o releases, el patrón exige revisión de estado, checks y autorización antes de ejecutar.
- Audit before change.
- No inventar resultados.
- Pre-Merge Audit.
- Rollback o Manual Fallback cuando aplique.
Un prompt útil expresa un contrato de trabajo
DCP Flow no trata prompts como frases mágicas. Un prompt fuerte combina outcome, contexto suficiente, acción solicitada, límites, evidencia esperada y autoridad explícita. La metodología sigue viviendo en DCP Flow y la verdad del proyecto en el repositorio; el prompt solo reduce ambigüedad sobre la interacción actual.
- Outcome claro.
- Contexto suficiente.
- Scope y límites.
- Evidence + authority explícitas.
El patrón cambia según la etapa del lifecycle
El Cookbook distingue patrones para auditar antes de tocar un proyecto, ejecutar Solution Discovery, preparar un sprint, crear un Execution Contract, hacer handoff, coordinar dos agentes, analizar infraestructura, diagnosticar incidentes, realizar Pre-Merge Audit, evaluar Deployment Readiness, preparar release y capturar aprendizaje. No se copia todo: se usa el patrón que corresponde al estado real.
- Audit antes de change cuando la verdad es incierta.
- PLAN / BUILD / REVIEW con límites claros.
- Pre-Merge Audit antes de integración.
- Release y retrospectiva tienen contratos distintos.
Recomendación no significa autorización
Pedir análisis o recomendación debe poder ocurrir sin abrir una ventana de ejecución accidental. Prompts como “hazlo todo”, “mejora lo que veas” o “mergea cuando termines” dejan decisiones materiales implícitas y aumentan el riesgo. El buen prompt aclara qué puede hacerse ahora y qué sigue sujeto a Human Gate.
- ASK puede terminar sin modificación.
- No autoautorizar merge o release.
- No ampliar scope por iniciativa del agente.
- Prompt expresa intención; evidence demuestra resultado.
Glosario contextual＋
Contrato de ejecución que fija objetivo, alcance, límites, evidencia y condiciones de aceptación.
Transferencia explícita de contexto, alcance, estado y evidencia entre personas o agentes.
Revisión previa a integración que busca conflictos, regresiones, deuda conocida y evidencia faltante.
Procedimiento manual, verificable y explícito usado cuando Kai no puede ejecutar directamente una acción.