Plantilla de trabajo con agentes

Swarm Task Progression

Un swarm ejecuta las tareas, un agente revisor independiente las audita contra la realidad, y la nota que emite alimenta el aprendizaje del swarm. Extraído de un sistema real que evolucionó de nota 8 a 10 en 6 entregas.

01El bucle de trabajo

Todo gira alrededor de un ciclo cerrado: el TODO define qué hacer, el swarm lo ejecuta y lo documenta, el revisor lo audita y puntúa, y esa nota realimenta al swarm. El repositorio git es la memoria compartida y el canal de comunicación entre agentes.

TODO.md qué está hecho / pendiente boot_swarm arranque systemd-style SWARM custom_agent.md + NOTA-AGENTE.md commits pequeños, informe de 8 secciones agents/reports/ informe-*.md + commits REVISOR diffea · contrasta · verifica nota 1–10 lectura NOTA-AGENTE.md — feedback → aprendizaje

02Tres roles, responsabilidades separadas

Cada rol tiene su carpeta y cada documento su dueño. La regla de oro: el evaluado jamás reescribe sus propias reglas.

🐝

El swarm — trabajo

swarm/custom_agent.md

Ejecuta tareas del TODO.md con commits pequeños y atómicos. Cada entrega termina con un informe de 8 secciones commiteado: «si no está escrito, no existe».

🔍

El revisor — verificación

revisor/REVISOR.md

Agente independiente que diffea commit a commit, recalcula a mano, verifica la frescura de los datos y emite la nota 1–10. «Juez y parte corrompería la señal».

👤

El propietario — orquestación

owner/boot_swarm.md

Humano que decide qué tarea se hace, aprueba cambios de protocolo y usa la nota como recompensa para la evolución del sistema.

03El barómetro de notas

La nota del revisor no es un simple número: lleva desglose de qué sumó, qué restó y por qué. Es la señal que guía la evolución del sistema.

≤7
Rechazo: datos inventados, informe ausente o regla dura violada
8
Trabajo sólido con 1 bug de datos o proceso, sin gravedad
9
Trazabilidad ejemplar, 1–2 deudas menores declaradas
10
Trazabilidad total + decisiones justificadas + deudas saldadas

Regla del sistema: un 90% correcto y auditable vale más que un 100% con un dato inventado. La nota del sistema original subió de 8 a 10 en 6 entregas gracias a este bucle.

04Anatomía del repositorio

No hay código ejecutable: es un sistema operativo de agentes hecho solo de Markdown y git.

├── TODO.md ← estado del proyecto: hecho / pendiente / ideas
├── AGENTS.md ← memoria del proyecto (gotchas, pipeline)
├── CONTEXTO.md ← decisiones vigentes entre sesiones
└── agents/
       ├── owner/boot_swarm.md ← arranque automático (systemd del swarm)
       ├── swarm/custom_agent.md ← protocolo de trabajo del swarm
       ├── swarm/NOTA-AGENTE.md ← feedback de evolución (lo escribe el revisor)
       ├── revisor/REVISOR.md ← protocolo y memoria del evaluador
       └── reports/ ← un informe por tarea, commiteado

05Los 5 principios que hacen funcionar el sistema

1Fuente de verdad explícitaTodo dato debe rastrearse a su origen. Nada inventado, nada «aproximado».
2Los datos viajan por pipelineSi viene de una fuente externa, existe un script que lo extrae y genera código. Los datos a mano mueren con el primer patch.
3Informe obligatorio a archivo8 secciones, commiteado como último commit. Sin informe, la entrega está incompleta.
4Separación de capasAprendizaje ≠ contrato ≠ memoria del proyecto. El evaluado jamás reescribe sus propias reglas.
5Commits pequeños y atómicosLa revisión diffea paso a paso y los errores se revierten con precisión quirúrgica. El git limpio es la infraestructura de todo lo demás.

06Lecciones del sistema real

El crash más tonto (un m[3] de un regex de 2 grupos) lo detectó el swarm, no el humano ni el revisor: la doble verificación funciona en ambas direcciones. — README del proyecto, lecciones aprendidas antes de tocar nada

07Montaje en 10 minutos

Comportamiento por defecto

⚡ Opción asistida — el camino recomendado

Es lo primero que deberías probar al hacer setup del proyecto. Carga agents/revisor/first_boot_revisor_builder.md en tu agente revisor y deja que haga el trabajo: te entrevista por bloques (identidad, stack, fuente de datos, zonas prohibidas, tareas), rellena la plantilla con tus respuestas, verifica que quedan 0 placeholders y commitea. Tú solo respondes preguntas.

// Opción manual — 6 pasos (si prefieres controlar cada ficha)
Copia la plantilla a la raíz — TODO.md y AGENTS.md deben vivir en la raíz del proyecto, no en una subcarpeta.
Sustituye los {{PLACEHOLDER}} — búscalos con Select-String "{{": nombre, gestor de paquetes, comandos de check/build, fuente de datos y ruta de informes.
Rellena TODO.md y AGENTS.md — cada gotcha que escribas es una hora que el swarm no perderá redescubriéndolo.
Primer commit — la revisión y el revert dependen de commits pequeños y atómicos.
Ejecuta el boot — carga boot_swarm.md: el swarm preguntará qué tarea quieres y trabajará según el protocolo.
Pide la revisión — carga REVISOR.md tras cada entrega: la nota 1–10 es tu recompensa para el aprendizaje.