> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes

> Agentes hijos que reparten el trabajo, agentes con nombre, orquestación y sesiones que hablan entre sí.

## Agentes hijos

El agente puede pasar partes de una solicitud a agentes hijos. Cada uno empieza de cero, trabaja en su parte y devuelve solo su respuesta final. Varios se ejecutan a la vez. Ves una línea por cada hijo bajo el paso que lo inició, y una aprobación que pide un hijo indica qué hijo es.

| Tipo | Qué hace |
| - | - |
| Inspeccionar | Solo lee. |
| Editar | Trabaja en un worktree de Git temporal de tu carpeta. Al terminar, sus cambios se fusionan en tu carpeta, sin pasarlos al stage ni hacer commit. Si hay conflictos, no se escribe nada y se guarda el parche. Necesita un repositorio Git. |
| En segundo plano | El agente sigue mientras el hijo trabaja; el resultado vuelve a la conversación cuando termina. |

Un hijo nunca puede hacer más que su padre: tu [modo de permisos](https://docs.archetype.ing/es/use/approvals.md) y tus reglas de aprobación se aplican también a sus llamadas. Un hijo con una pregunta se la hace primero a su padre; si el padre no responde en 10 minutos, la pregunta te llega a ti y aparece en **Te necesita**.

Los agentes hijos están activados para los modelos propios de Archetype, Claude Code y Codex. Desactívalos con `"children": false` en tu configuración de usuario.

**Tokenmaxxing** da prioridad a la velocidad: el agente divide el trabajo en partes independientes y las ejecuta todas a la vez como hijos. Actívalo desde la barra de estado o con `/tokenmaxxing`.

## Agentes con nombre

Vienen dos agentes incluidos: `general` y `explore`, que solo lee. Añade los tuyos como archivos Markdown; el agente elige uno por su nombre y su descripción.

```markdown theme={null}
---
name: reviewer
description: Reads the changed files and finds bugs and missing tests
mode: inspect        # inspect or edit; without it, the task decides
tools: [read_file, search_text]   # without it, every tool of the mode
model: gpt-6-luna    # a model of the parent's provider; without it, the parent's
max-turns: 30        # 1 to 200; without it, no limit
---

Read the change closely. For each problem, give the path, the line and why.
```

| Dónde | Para |
| - | - |
| `~/.config/archetype/agents/*.md` | Ti, en todas las carpetas |
| `.archetype/agents/*.md` | Este proyecto |

El tuyo reemplaza a un agente incluido con el mismo nombre. El agente de un proyecto solo añade nombres nuevos: uno que se llame como uno incluido o como uno tuyo se omite con un aviso, así un repositorio clonado no puede cambiar lo que hace `explore`.

## Orquestación

Para un trabajo más grande que una conversación, una sesión dirige a otras.

**1. Iníciala**

Escribe `/orchestration` y lo que quieres, o elige **Orquestar** en el menú de nueva sesión de una carpeta.

**2. Acepta el plan**

La sesión principal escribe un plan: los pasos, qué significa terminado en cada uno y qué motor lo hace. No empieza nada hasta que respondes “Start”. Pide cambios con tus palabras y lo reescribe.

**3. Se ejecutan los pasos**

Cada paso se ejecuta en su propia rama, hasta 3 a la vez. Cuando un paso termina, otro motor lo revisa si hay alguno con sesión iniciada. Un paso que falla su revisión dos veces te espera.

**4. Recoge el resultado**

Por defecto termina con la pull request de cada paso lista y sus comprobaciones superadas; la sesión principal propone en qué orden fusionarlas.

Las preguntas de un paso van primero a la sesión principal; lo que solo tú puedes decidir llega a su conversación. Los ajustes están en `orchestration` en tu configuración; `"orchestration": false` lo desactiva.

## Sesiones que hablan entre sí

Las conversaciones del mismo ordenador pueden enviarse mensajes (con el protocolo [A2A](https://a2a-protocol.org/)). Pide al agente que consulte con otra sesión o que empiece trabajo en otra carpeta.

* Un mensaje a una sesión que está trabajando se une a su solicitud actual; si no, inicia una nueva allí.
* La sesión que lo recibe trabaja con sus propios permisos y pide sus propias aprobaciones.
* Enviar a otra sesión y detenerla pregunta antes en el modo `ask`, y se rechaza en `read-only`.
* El agente solo abre una sesión nueva cuando se lo pides; si no, reparte el trabajo en agentes hijos.
* Tras 8 mensajes de ida y vuelta sin ninguna persona, no se envían más.

Desactívalo con `"a2a": false`; en la configuración de un proyecto lo desactiva solo para esa carpeta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.