Prompt Cookbook institucional
Patrons d’interacció per audit, discovery, sprint, handoff, treball paral·lel, Git/Kai, infraestructura, incidents, QA, deployment i release.
Patrons d’interacció per audit, discovery, sprint, handoff, treball paral·lel, Git/Kai, infraestructura, incidents, QA, deployment i release.
El Prompt Cookbook institucional no és una col·lecció de frases màgiques. Ofereix patrons per donar a humans i agents un contracte de treball clar, amb context, límits, resultat esperat i evidència.
Patrons d’interacció
Els patrons cobreixen discovery, audit, sprint, handoff, treball paral·lel, Git, infraestructura, incidents, QA, deployment i release. El prompt ha de descriure treball d’enginyeria, no una ordre ambigua.
- Objectiu i context.
- Scope i Non-Goals.
- Restriccions i autoritat.
- Evidence i Definition of Done.
Prompts que redueixen risc
En tasques sensibles es demana auditar abans de canviar, separar fets d’inferències i aturar-se quan falta informació necessària. Per merges o releases cal revisar estat, checks i autorització.
- Audit before change.
- No inventar resultats.
- Pre-Merge Audit.
- Rollback o Manual Fallback quan correspongui.
Un prompt útil expressa un contracte de treball
DCP Flow no tracta els prompts com frases màgiques. Un prompt fort combina outcome, context suficient, acció sol·licitada, límits, evidència esperada i autoritat explícita. La metodologia continua vivint a DCP Flow i la veritat del projecte al repositori; el prompt només redueix ambigüitat sobre la interacció actual.
- Outcome clar.
- Context suficient.
- Scope i límits.
- Evidence + authority explícites.
El patró canvia segons l’etapa del lifecycle
El Cookbook distingeix patrons per auditar abans de tocar un projecte, executar Solution Discovery, preparar un sprint, crear un Execution Contract, fer handoff, coordinar dos agents, analitzar infraestructura, diagnosticar incidents, fer Pre-Merge Audit, avaluar Deployment Readiness, preparar release i capturar aprenentatge. No es copia tot: s’utilitza el patró que correspon a l’estat real.
- Audit abans de change quan la veritat és incerta.
- PLAN / BUILD / REVIEW amb límits clars.
- Pre-Merge Audit abans d’integració.
- Release i retrospectiva tenen contractes diferents.
Recomanació no significa autorització
Demanar anàlisi o recomanació ha de poder passar sense obrir accidentalment una finestra d’execució. Prompts com “fes-ho tot”, “millora el que vegis” o “mergea quan acabis” deixen decisions materials implícites i augmenten el risc. El bon prompt aclareix què es pot fer ara i què continua subjecte a Human Gate.
- ASK pot acabar sense modificació.
- No autoautoritzar merge o release.
- No ampliar scope per iniciativa de l’agent.
- Prompt expressa intenció; evidence demostra resultat.
Glossari contextual＋
Contracte d’execució que fixa objectiu, abast, límits, evidència i condicions d’acceptació.
Transferència explícita de context, abast, estat i evidència entre persones o agents.
Revisió prèvia a integració per detectar conflictes, regressions, deute conegut i evidència absent.
Procediment manual, verificable i explícit utilitzat quan Kai no pot executar directament una acció.