For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/desktop/agents.md (or send Accept: text/markdown).
Construye con un agente de código
Entregue tareas a un agente de codificación: los archivos que lee, los skills incluidos y la revisión que le mantiene en control.
Guía paso a paso para principiantes
Requisitos previos: lea las dos guías para principiantes a continuación y termine la configuración local de Desktop. Un agente de codificación es una herramienta de IA —Cursor, Claude Code, Devin o un asistente similar— que lee su proyecto, edita archivos y ejecuta comandos. Todo lo de esta página se aplica a cualquiera que use.
Términos rápidos: un prompt es el texto de instrucciones que pegas en el agente. Un diff es la lista de cambios de archivos que propone. La raíz del repositorio es la carpeta superior que contiene package.json — el agente siempre debe empezar ahí.
1. Abra .agents/skills/ en la raíz del repositorio y copie el skill más cercano a su tarea: add-a-desktop-capability es un buen primer intento.
2. Péguelo en su agente y describa su cambio, luego agregue una línea: Lea llms.txt, luego AGENTS.md, luego .ai/PROJECT_CONTEXT.md antes de tocar el código.
3. Deja que el agente liste los archivos que cambiará y las comprobaciones que ejecutará antes de editar. Cuando termine, revisa el diff — estás aprobando cambios reales en tu producto.
4. La publicación, la liberación de instaladores y las llamadas a proveedores de pago nunca forman parte de un prompt de tarea. Manténgalas como pasos separados que usted aprueba explícitamente.
Los archivos que lee tu agente
El repositorio incluye un pequeño conjunto de archivos escritos para agentes, no solo para personas. Nunca pegas este contexto a mano — apunta al agente a llms.txt y él lee el resto por sí solo.
El orden de lectura importa: llms.txt es el mapa, AGENTS.md fija los límites y .ai/PROJECT_CONTEXT.md guarda lo que aprendieron las sesiones anteriores. Un agente que se salta los límites produce código que no puedes lanzar.
| Archivo | Qué le da al agente |
|---|---|
| `llms.txt` | El mapa de entrada del repositorio, generado para listar solo lo que este checkout realmente incluye |
| `AGENTS.md` | Los límites innegociables: solo trabajo local hasta que usted apruebe más, el shell nunca bifurca UI de producto |
| `.ai/PROJECT_CONTEXT.md` | Memoria entre sesiones — qué cambió recientemente y por qué; se lee antes de modificar código |
| documentos espejo `.ai/` | Una nota `.ai/<ruta>.md` junto a los archivos importantes, que registra decisiones por archivo e hilos abiertos |
| `.agents/skills/` | Runbooks de tareas escritos para agentes: los cinco skills de Desktop enumerados a continuación |
| `docs/agent-security.md` | La lista de verificación de aceptación: autenticación, verificaciones de workspace y permisos, registros redactados |
| `docs/desktop-updates.md` | El runbook del canal de actualización: claves de firma, endpoints y canales de lanzamiento |
| `.env.example` | El inventario completo del entorno — el agente nunca inventa un nombre de variable ausente de este archivo |
Los skills incluidos
Cada archivo bajo .agents/skills/ es un briefing completo: péguelo o deje que el agente lo lea, y las reglas del kit viajan con él —la UI de producto permanece en la aplicación web, solo el comportamiento de SO va a Rust.
La biblioteca prompts/ lista para pegar solo se incluye en el repositorio Web; este checkout incluye skills en su lugar. Para una configuración desatendida, use el prompt preparado en la guía de agent-setup.
add-a-desktop-capability: cambios de ventana, bandeja, atajo, actualización o compilaciónadding-a-dependency: agregar, actualizar o mover una dependencia npm de forma segurareviewing-a-pr: revisar un diff en busca de corrección, aislamiento de workspace y secretosupgrading-from-upstream: traer una versión más reciente del kit a su shellverify-changes: elegir y ejecutar las verificaciones correctas antes de la entrega
Cómo recuerda el agente entre sesiones
Los agentes no tienen memoria entre sesiones: la carpeta .ai/ es la memoria. .ai/PROJECT_CONTEXT.md registra lo que cambió recientemente y por qué. Junto a él, un documento espejo como .ai/apps/desktop/src-tauri/src/lib.md explica las decisiones detrás de apps/desktop/src-tauri/src/lib.rs que el código por sí solo no muestra.
El contrato es simple: lee el espejo de un archivo antes de editarlo y actualiza el espejo cuando el cambio aterrice. Las entradas de «Open Threads» registran trabajo sin terminar para que la próxima sesión retome en lugar de empezar de cero. Un espejo desactualizado es peor que ninguno — cuando revises el diff del agente, comprueba que los espejos de los archivos cambiados se movieron con él.
Revisa el trabajo del agente con honestidad
Una tarea terminada es evidencia, no un resumen. Antes de quedarte con el trabajo del agente, compruébalo como docs/agent-security.md comprueba un despliegue:
Cuando algo está mal, devuelve el diff — el agente corrige su propio trabajo más rápido cuando nombras la comprobación que falla. Para cualquier cosa que nunca debió intentar solo, dilo explícitamente una vez; el límite se mantiene el resto de la sesión.
- Ejecutó las verificaciones que afirma —cargo test, cargo check o el preflight de lanzamiento—: pida el comando y su salida, no una conclusión.
- Los secretos permanecieron solo en el servidor: ninguna clave de firma o certificado se imprimió en un informe o commit, y el shell sigue sin llevar credenciales de proveedores.
- El comportamiento del producto permaneció en la aplicación web: el diff no agrega UI, autenticación ni lógica de chat paralela en Rust.
- El espejo
.ai/de cada archivo cambiado se movió junto con el código. - La publicación, la liberación de instaladores y las llamadas a proveedores de pago permanecieron como pasos separados que usted aprobó: el agente nunca fusionó, subió ni liberó por su cuenta.
- Si un paso falló dos veces, se detuvo e informó del comando fallido en lugar de improvisar para rodearlo.
Si quieres continuar la configuración, lee Crear las cuentas de lanzamiento de escritorio.