Apartment38/Agent-Skills

Delegación Paralela de Agentes

Úsalo cuando distribuyas trabajo a varios subagentes en una sola llamada delegate_task, especialmente cuando crean o editan archivos. La mayoría de los sobrecostes y árboles corruptos aquí provienen de que dos agentes crean que son dueños del mismo archivo.

Cuándo Usarlo

Cualquier distribución multi-agente donde las tareas afecten al mismo repositorio, directorio o proyecto — creación de archivos, refactorizaciones divididas por área, o divisiones de compilación-y-prueba.

Procedimiento

1. Segmenta antes de enviar, por ruta. Dale a cada tarea propiedad exclusiva de archivos o directorios nombrados. Dos agentes no pueden escribir el mismo archivo, y ningún archivo puede quedar sin asignar. Prefiere menos segmentos, claramente más grandes, sobre muchos superpuestos.

2. Indica rutas absolutas en cada resumen de tarea. Las rutas relativas se resuelven contra un directorio de trabajo diferente dentro de algunos agentes, lo que hace que el trabajo termine en ~/fixture en lugar de ~/Projects/app/fixture. Incluye una línea explícita "no crear nada fuera de este árbol".

3. Asigna un único propietario por archivo compartido. Los archivos de configuración, manifiestos y registros de lista son reclamados por una sola tarea por nombre; indica a los demás que no deben editarlo, solo informar de lo que debería contener.

4. Prohíbe los efectos secundarios que no desees. Di explícitamente si las instalaciones, compilaciones, ejecuciones de pruebas y commits de git están permitidos. Las instalaciones no supervisadas dispersan node_modules en directorios no relacionados.

5. Solicita un informe verificable por máquina: rutas absolutas exactas creadas, qué se verificó y cómo se verificó (analizado, renderizado, compilado, probado unitariamente). El éxito auto-reportado sin un método de verificación es ruido.

6. Verifica tú mismo el resultado fusionado antes de confirmar o informar: compila, ejecuta la suite de pruebas y lee los archivos críticos. No confíes en que N informes independientes compongan un árbol funcional.

7. Busca archivos huérfanos. Busca fuera del árbol de destino directorios que los agentes puedan haber creado (raíz del home, directorios de proyectos hermanos, scratch). Reconcílialos antes de que termine la sesión.

Reglas siempre activas

• Los archivos eliminados son un síntoma: cuando dos agentes podan rutas "no utilizadas", cada uno elimina lo que el otro acaba de escribir. Asigna explícitamente los derechos de eliminación.
• No bloquees tu propio turno esperando a agentes hermanos; continúa el trabajo independiente y actúa cuando lleguen sus resultados.
• Cuando los resultados lleguen después de que ya hayas terminado y confirmado, verifica el estado del árbol de trabajo y los archivos huérfanos, luego decide qué queda por hacer — no des por sentado que el árbol está limpio, ni que su trabajo entra en conflicto.
• Mantén el número de agentes escribiendo en un mismo artefacto lo más bajo posible; distribuye libremente en análisis de solo lectura, con moderación en escrituras.

Errores Comunes

• Colisiones de nombres compartidos. Dos resúmenes que describen "los archivos CSS" o "la configuración" enrutan a rutas diferentes por agente; nombra las rutas absolutas exactas.
• Deriva de convenciones. Los agentes que ven un árbol parcialmente construido adoptan la disposición de otro en mitad del vuelo, dejando dos convenciones en un proyecto; fija la disposición en el resumen.
• Confiar en verificaciones no ejecutadas. Los informes que afirman que una compilación o renderizado pasaron sin evidencia generalmente significan que se juzgó estructuralmente; reprodúcelo.
• Colisiones de limpieza. Un agente que elimina sus propios archivos "ahora-muertos" puede eliminar el entregable de un hermano — consulta la regla siempre activa anterior.

Archivos de apoyo

• templates/delegation-brief.md — plantilla de resumen de tarea para copiar y rellenar que impone la propiedad de rutas, efectos secundarios prohibidos y un formato de informe verificable.