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 skills

Qué hace cada paso

PasoSkillQué hace
Brief/task (task-context)Trae la tarea, monta un brief de una pantalla, crea la rama y elige el tipo de tarea.
PreguntargrillTe entrevista sobre un árbol de decisiones hasta que no queda ninguna abierta. Busca él mismo los datos del repo y nunca edita archivos.
Rutadiagnose-bug y otrasLos 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.
Verificarverify-ps-project, blast-radiusComprueba el cambio en la tienda real y encuentra qué podría romper fuera del diff.
Revisartask-reviewLee el diff contra el brief de la tarea y el AGENTS.md del repo, en dos ejes separados. Solo lectura.
Entregarmr-flowRama, commit, push, abrir y mergear la merge request, solo los pasos que pidas.
Cerrar/task doneRegistra el tiempo con los números que le des.
AprenderreflectConvierte 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 (los ps-*, las skills de bootstrap) no forman parte de ella.

El origen de este mapa es docs/workflow.md en el repo de mallard.

On this page