Guides
Flujo de trabajo
Cómo encadenan las skills de mallard en una tarea, del brief a la merge request, y qué paso se encarga de qué.
Las skills de mallard están pensadas para usarse en secuencia. Cada paso es una
skill que arrancas tú, y cada skill termina con una línea Next: que apunta a
la siguiente. Nada ejecuta la cadena por ti: cada commit, push, merge request,
registro de tiempo o mensaje a cliente espera tu OK.
La cadena sirve para cualquier stack que mallard cubre: PrestaShop, Laravel, PHP plano o JS. Los pasos propios de cada stack viven dentro de cada skill.
La cadena
/task <id> brief + rama + tipo
|
|-- ¿brief fino o poco claro? grill
v
ruta por tipo bug -> diagnose-bug
traducción, imagen, layout, seguridad -> la skill o agente que /task nombra
v
verificar verify-ps-project (PrestaShop), los tests del proyecto (Laravel)
blast-radius si cambió código compartido
v
task-review diff contra el brief y AGENTS.md, solo lectura
v
mr-flow rama, commit, push, merge request
v
/task done <id> registrar tiempo
v
reflect convertir errores repetidos en ediciones de skillsQué hace cada paso
| Paso | Skill | Qué hace |
|---|---|---|
| Brief | /task (task-context) | Trae la tarea, monta un brief de una pantalla, crea la rama y elige el tipo de tarea. |
| Preguntar | grill | Te entrevista sobre un árbol de decisiones hasta que no queda ninguna abierta. Busca él mismo los datos del repo y nunca edita archivos. |
| Ruta | diagnose-bug y otras | Los bugs reciben un bucle de feedback repetible (un test Pest o PHPUnit que falla, un script de tinker, un curl local). El resto de tipos va a su propia skill. |
| Verificar | verify-ps-project, blast-radius | Comprueba el cambio en la tienda real y encuentra qué podría romper fuera del diff. |
| Revisar | task-review | Lee el diff contra el brief de la tarea y el AGENTS.md del repo, en dos ejes separados. Solo lectura. |
| Entregar | mr-flow | Rama, commit, push, abrir y mergear la merge request, solo los pasos que pidas. |
| Cerrar | /task done | Registra el tiempo con los números que le des. |
| Aprender | reflect | Convierte las correcciones repetidas en ediciones de skills que tú apruebas. |
Reglas
- Un responsable por paso. Una skill que necesita otra la carga por nombre en vez de copiar su texto.
- Toda acción externa espera tu OK: commit, push, merge request, registro de tiempo, mensajes a cliente.
- Una skill que encaja en la cadena recibe una línea
Next:. Las herramientas fuera de la cadena (losps-*, las skills de bootstrap) no forman parte de ella.
El origen de este mapa es docs/workflow.md en el repo de mallard.