AI Office

Qué es y cómo se abre

AI Office se abre como una ventana a pantalla completa por encima de toda la app. No es una de las cinco páginas del pager principal. No tiene atajo de teclado, ni entrada en la paleta de comandos, ni enlace profundo: las cuatro rutas de abajo son las únicas, y las cuatro pasan por la misma comprobación de Pro.

Formas de abrirlo

Pro, comprobado una sola vez en la puerta

• AI Office es un módulo Pro entero. En Free, todas las rutas de arriba muestran el muro de pago de Pro (el Office aparece en IA que trabaja sola, junto a Cortex, Swarmcode y el Diseñador con IA) y el Office no se abre.
• Una vez dentro, nada más depende del plan salvo el número de proyectos (mira Free y Pro). Los proveedores de IA no forman parte del plan: traes tu propia clave.

Cómo se comporta la ventana

• Cerrar la ventana no pausa una oficina en marcha. Sigue trabajando, protegida por una notificación en primer plano, hasta que termina o la pausas.
• Atrás (el gesto del sistema): desde Bienvenida cierra el Office; desde Mis Oficinas, el Lobby y Actividad va a Bienvenida (dentro del Lobby primero vuelve una página); desde Analizar, la revisión del plan y Proveedor IA vuelve al Lobby; desde Planificando cancela la planificación y vuelve al Lobby; desde Tablero, Chat y Resultados va a Actividad.

El equipo: ocho roles

El Office tiene ocho roles. No son ocho agentes fijos: tú eliges el equipo, desde un solo agente hasta los ocho, y hay un agente por cada rol que seleccionas. La tabla dice qué hace cada rol en la app.

Tu equipo

• El Lobby lista los ocho roles, cada uno con un interruptor. El Director de Proyecto lleva un candado (Requerido) y no se puede apagar, así que un equipo tiene de 1 a 8 agentes.
• El equipo por defecto tiene cinco: Director de Proyecto, Arquitecto, Desarrollador Frontend, Desarrollador Backend e Ingeniero QA. Cada plantilla sugiere su propio equipo y siempre añade al Director de Proyecto.
• Las revisiones existen solo si el equipo tiene un Ingeniero QA: sin ninguno, las tareas se aceptan sin revisar.
• El Orquestador que ves en el Chat y el investigador de Analizar no son roles: son funciones del motor del Office.

Qué modelo usa cada rol

• No eliges un modelo por rol. Al pulsar Iniciar Oficina, el Office elige para cada rol el mejor modelo entre los proveedores que tienen clave, y lo enseña en la tarjeta del rol de la página del equipo, en la hoja del agente de Actividad y en Rendimiento de Agentes de Resultados.
• Agrupa los roles en tres niveles: los modelos más potentes para Director de Proyecto, Arquitecto e Ingeniero QA; los rápidos y capaces para Desarrollador Frontend, Desarrollador Backend e Ingeniero de Datos; los más baratos y rápidos para DevOps y Redactor Técnico.
• Si sesiones anteriores del mismo proyecto vinculado muestran que otro proveedor rinde claramente mejor para un rol (al menos 3 muestras y más de 15 puntos de éxito), cambia ese rol a ese proveedor.

No puedes, y por qué

• Elegir el modelo, el proveedor o el nivel de razonamiento de un solo rol: el Office no tiene un control para eso, y lo que eliges en Proveedor e Modelo IA tampoco lo fija.Aún no
• Apagar al Director de Proyecto: siempre está en el equipo.A propósito
• Desplegar desde dentro del Office: no está conectado al Backend Manager, así que no hay paso ni botón de despliegue. Despliega desde el Backend Manager.A propósito
• Usar el Office sin ningún proveedor de IA conectado: sin clave, la primera llamada falla y el Lobby muestra «La planificación falló — revisa el registro de chat para más detalles».Requiere red

Bienvenida y Mis Oficinas

Bienvenida es la primera pantalla del Office. Desde aquí abres tus oficinas o empiezas una sesión nueva.

Bienvenida

Dos acciones y tres tarjetas informativas bajo Características. En horizontal las tarjetas informativas quedan a la izquierda y las acciones a la derecha; en vertical todo va apilado en una columna.

Mis Oficinas

Las oficinas son las sesiones que has empezado: la actual y las pasadas. Arriba hay tres contadores: Total, Activas (oficinas ejecutándose ahora) y Completadas. Una tarjeta muestra el nombre, el estado, las primeras líneas del encargo, una barra con las tareas hechas y chips con el número de agentes, el número de sprints, la fecha, los tokens estimados (~Xk tok) y Proyecto vinculado. El estado tiene siete etiquetas; una oficina que espera una revisión de sprint y una cancelada se muestran como Configuración.

El Lobby: encargo, equipo y Config

El Lobby es un asistente de dos páginas. La página 1 es ¿Qué construimos hoy?; la página 2 es Tu equipo, y desde ella se abre la hoja Config. Atrás vuelve de la página 2 a la 1.

Página 1: qué construir

Un cuadro de texto grande, tres chips de ejemplo, un carrusel de plantillas y, si ya tienes proyectos, una forma de construir sobre uno. «Descríbelo con tus palabras. Tu equipo se encarga del resto.»

Página 2: tu equipo

Tu equipo tiene el nombre del proyecto, una tarjeta por rol y el botón Ajustar detalles.

La hoja Config

Ajustar detalles abre una hoja titulada Config. Existe solo en el Lobby: una vez que pulsas Iniciar Oficina no puedes cambiar nada de lo que hay en ella. Estos son sus controles, en orden.

Lo que hacen de verdad los controles

• El Modo Rápido siempre se salta las preguntas aclaratorias, le pide al planificador de 3 a 5 tareas de 2 a 4 archivos cada una y sube Tareas paralelas a 2 si estaba en 1. Aprueba el plan solo y se salta la revisión QA únicamente cuando el proyecto se evalúa como Trivial o Simple; de Moderate en adelante sigues revisando el plan y QA sigue revisando.
• Habilitar revisiones QA: una revisión existe solo si el equipo tiene un Ingeniero QA. Si la propia llamada de revisión falla, la tarea se acepta sin revisar y el chat lo dice. En el último reintento permitido, una salida de más de 200 caracteres se aprueba automáticamente.
• Tool-calling nativo: activado, los agentes usan las llamadas de herramientas nativas del proveedor, con las mismas puertas de permisos que AI Chat y los archivos encerrados en la carpeta de trabajo. Desactivado, usan el protocolo de texto antiguo, con una lista fija de herramientas por rol y nivel de riesgo y hasta 8 rondas de herramientas por tarea.
• Tareas paralelas: el deslizador llega a 4 pero el Office ejecuta como máximo 3 tareas a la vez, y solo las que el plan marca como paralelas y que declaran sus archivos. El workflow de Entrega de feature, SPARC y Auto (que por defecto es Entrega de feature) suben el mínimo a 2, lo que desactiva Best-of-N.
• Máximo de sprints: al planificador se le pide como máximo el menor de Máximo de sprints y los sprints sugeridos más uno. La sugerencia es 1 para Trivial y Simple, 2 para Moderate, 3 para Complex y 5 para Massive.
• Intentos Best-of-N: en cada tarea de código hace N intentos uno tras otro y se queda con el que pasa la comprobación local, así que cuesta unas N veces los tokens en esas tareas. Solo funciona con Tareas paralelas en 1 y el tool-calling nativo activado, en el primer intento de cada tarea.
• Adversarial review: un panel de N jueces escépticos (de 1 a 5, con un quórum y hasta 3 jueces a la vez) revisa cada tarea en lugar del único Ingeniero QA. Necesita las revisiones QA activadas y un Ingeniero QA en el equipo, y multiplica las llamadas. Todo lo de este interruptor se muestra en inglés.
• Sistema de diseño, Playbook y Workflow de trabajo moldean los prompts de los agentes; no añaden herramientas ni pasos de aprobación.

No puedes, y por qué

• Elegir SPARC: el Office tiene este playbook, pero el selector muestra ocho tarjetas y SPARC no es una de ellas. Auto solo lo activa si tu encargo contiene «sparc», «specification pseudocode» o «pseudocode architecture».Aún no
• Hacer que Auto-aprobar planes haga algo: nada en la app lo lee. Para saltarte la revisión del plan usa el Modo Rápido, que solo vale para proyectos Trivial y Simple.Aún no
• Fijar un límite de tokens, un límite de tiempo, una estrategia de testing o un modo estricto para las herramientas: existen en los ajustes del Office, pero ningún control los muestra.Aún no
• Cambiar la Config de una oficina después de pulsar Iniciar Oficina: la hoja solo existe en el Lobby.A propósito

Workflow de trabajo: cómo se planifica el trabajo

Cada tarjeta le dice al Director de Proyecto cómo planificar y repartir el trabajo: da forma al prompt de planificación y a qué agente se le asigna cada tarea. No añade herramientas ni pasos de aprobación por su cuenta.

Playbook: el listón de calidad

Un playbook es un bloque de reglas que se añade al prompt de todos los agentes. Los nombres y las descripciones son texto fijo en inglés.

Planificación y revisión del plan

Tras Iniciar Oficina planifica el Director de Proyecto. La pantalla Creando Tu Plan muestra tres líneas fijas (Ensamblando agentes…, Analizando requisitos…, Creando desglose de tareas…) que no son una barra de progreso real, y un botón Cancelar; Atrás también cancela y vuelve al Lobby.

Qué hace la planificación

1. 1Elige el workflow (con Auto, según las palabras de tu encargo).
2. 2Hace las preguntas aclaratorias del Director de Proyecto, salvo que el Modo Rápido esté activo.
3. 3Evalúa la complejidad de 1 a 5: Trivial, Simple, Moderate, Complex o Massive. Si la llamada de evaluación falla, supone Moderate.
4. 4Le pide al modelo el plan como sprints y tareas, cada una con título, descripción, rol, prioridad, dependencias, archivos, skills, criterios de aceptación, riesgo, esfuerzo y si puede ejecutarse en paralelo. El plan se escribe en el idioma de tu dispositivo.
5. 5Asigna cada tarea al agente de tu equipo que mejor encaja y, si el equipo tiene un Ingeniero QA, a un Ingeniero QA distinto del asignado como revisor.
6. 6Termina en la revisión del plan. Con el Modo Rápido activo y un proyecto evaluado como Trivial o Simple, empieza a trabajar directamente. Si el plan no se puede leer, crea una única tarea genérica y lo dice en el chat.

Preguntas Rápidas

Salvo que el Modo Rápido esté activo, el Director de Proyecto empieza haciendo de 3 a 5 preguntas, cada una con 3 o 4 opciones de respuesta, en el idioma de tu dispositivo. «Responde para que el PM cree un plan más preciso.»

Revisar Plan

La pantalla muestra la complejidad (un chip en inglés: TRIVIAL, SIMPLE, MODERATE, COMPLEX o MASSIVE), la Estrategia que explica el Director de Proyecto y los Sprints, cada uno con su número de tareas.

Aprobaciones y complejidad

• Aprobar el plan es la confirmación propia del Office. En los proyectos evaluados como Complex o Massive hay otra entre sprints: la oficina se detiene en Revisión de Sprint y la barra inferior muestra Saltar Sprint y Aprobar.
• El Modo Rápido se salta la revisión del plan solo en proyectos evaluados como Trivial o Simple. Auto-aprobar planes no hace nada.
• De Moderate en adelante, las tareas estimadas como Large o Extra Large se dividen en subtareas más pequeñas mientras la oficina trabaja. Los proyectos Complex y Massive retienen las tareas de código hasta que se terminan las de arquitectura.

Actividad: la oficina trabajando

Una vez aprobado el plan, la oficina trabaja en cuatro pantallas entre las que puedes deslizar o que abres con los cuatro iconos de la barra inferior: Actividad, Tablero, Chat y Resultados. La cabecera muestra el nombre del proyecto, un punto que late mientras la oficina planifica o trabaja, y una línea con el sprint, cuántos agentes trabajan (N trabajando) y los tokens estimados (~N tokens (est.)). A la derecha está el icono Guardar (mira Qué escribe en tu proyecto). Actividad es el hogar de una oficina en marcha.

La barra de acción

Pausar, reanudar y qué conservan

• Pausar detiene todo al instante: la llamada a la IA en curso se descarta y su resultado parcial se pierde, y una tarea en curso vuelve a Por Hacer y empieza de cero cuando reanudas. Los archivos ya escritos se quedan como están.
• Reanudar relanza el plan desde donde estaba. Reintentar devuelve a Por Hacer las tareas fallidas (con sus reintentos a cero) y las bloqueadas, y reanuda. Saltar Sprint marca el sprint como omitido, bloquea sus tareas sin terminar y pasa al siguiente.
• Cuando acaba el trabajo: si todas las tareas están hechas, la oficina queda Completado; si unas están hechas y otras han fallado o están bloqueadas, se detiene en pausa con un mensaje del tipo «N/M tasks completed, N failed, N blocked», para que reintentes, re-planifiques o guardes lo que tienes; si ninguna salió bien, queda Fallido.
• Una tarea fallida se vuelve a intentar hasta Reintentos máx. por tarea veces, esperando 3, 6, 12 y luego 24 segundos antes de cada nuevo intento. Cuando fallan dos tareas seguidas, la oficina se pausa sola («⚠ N consecutive failures detected. Pausing to reassess the plan…»). También se pausa cuando un agente te hace una pregunta, y cuando falta la carpeta de su proyecto y tu plan no admite otro proyecto.

Las aprobaciones de herramientas se deciden en AI Chat

• El Office no tiene un diálogo de aprobación propio para las herramientas. Lo que los agentes hacen con herramientas pasa por las mismas puertas que AI Chat: las herramientas que denegaste en Permisos de herramientas IA (Ajustes → IA), la comprobación de lo arriesgado que es cada comando de terminal, el nivel de acceso del chat (Sin herramientas, Solo lectura, Preguntar, Editar solo, Acceso total) y la aprobación de todo lo que sale del dispositivo, como un git push, un curl o un ssh.
• Lo que necesita tu visto bueno se aparca en una cola y el agente sigue trabajando: se le dice que la acción no se ejecutó y quedó en cola. Las tarjetas aparecen en AI Chat, y el panel Actividad del chat lista el AI Office en Te esperan · N. Apruébalo o recházalo allí: el Office nunca pregunta dentro de sus propias pantallas.
• Con el nivel por defecto, Editar solo, las ediciones de archivos se hacen sin preguntar, pero ejecutar comandos y todo lo que sale del dispositivo esperan tu visto bueno. Con Preguntar, escribir archivos también pregunta, incluso cuando el Office escribe los bloques de código de una respuesta al terminar una tarea: cada archivo espera en la misma cola y no se escribe hasta que lo apruebes. Con Solo lectura o Sin herramientas, las herramientas de los agentes se rechazan y el Office tampoco escribe archivos por su cuenta.

Qué escribe en tu proyecto

Esta es la sección que más importa: el Office escribe en un proyecto real tuyo mientras trabaja.

Dónde escribe

• Con un proyecto vinculado, trabaja en la propia carpeta de ese proyecto y modifica sus archivos existentes; se le dice que amplíe lo que hay y no que cree un proyecto nuevo.
• Sin proyecto vinculado, crea una carpeta con el nombre del proyecto dentro de la carpeta projects/ de la app, y esa carpeta pasa a ser un proyecto más de tu lista. Si ya existe una carpeta con ese nombre, el Office trabaja en ella. El nombre sale de las tres primeras palabras de tu encargo salvo que edites Nombre del Proyecto.
• Al empezar, el chat dice dónde va a escribir: «Working in the linked project: …» o «No project linked — the team will work in a new project: …».
• Los agentes no pueden escribir fuera de esa carpeta: las rutas con .. o absolutas se descartan, y un enlace simbólico que apunte fuera de la carpeta se rechaza.

Cómo se escriben los archivos

• Mientras una tarea se ejecuta (tool-calling nativo, el valor por defecto) los agentes crean y editan archivos y ejecutan comandos con las herramientas de la app, encerrados en la carpeta de trabajo.
• Cuando una tarea termina, el Office escribe además los archivos que encuentra en la respuesta del agente (bloques de código con un path=, o el primer bloque de código en los archivos objetivo de la tarea). Con Preguntar, cada archivo pasa por la misma cola de aprobaciones que las herramientas de los agentes: se aparca en AI Chat y no se escribe hasta que lo apruebes. Con Editar solo o más se escribe sin preguntar; con el nivel de acceso Solo lectura o Sin herramientas este paso se omite y el Office no escribe nada por su cuenta.
• Una revisión QA lee texto. Además, el Office comprueba el trabajo en local: el HTML y el CSS del Desarrollador Frontend pasan una comprobación de estructura, y un script que escribió el agente (Python, JavaScript, Ruby, PHP y alguno más) se ejecuta en tu dispositivo con los mismos intérpretes que el botón Ejecutar del editor, durante 30 segundos como máximo. Un fallo real devuelve la tarea para otro intento (solo en el primer intento y con las revisiones QA activadas).
• Una comprobación de honestidad aparte compara lo que un informe dice que ejecutó con los comandos que de verdad se ejecutaron. Una tarea que presume de una prueba que nadie lanzó se devuelve o, sin reintentos (o si el agente no tiene forma de ejecutar comandos), termina marcada como Not verified by PocketCode.

Qué te pregunta

• Tu aprobación del plan, y de cada sprint en los proyectos Complex y Massive. Es la única confirmación del propio Office.
• El aviso de datos de tu proveedor de IA, una vez por proveedor y cuenta: el mismo aviso y el mismo registro que AI Chat. Si lo rechazas, no se envía nada.
• Las aprobaciones de herramientas, que se deciden en AI Chat (mira Actividad).

El icono Guardar

• Guardar, en la cabecera desde la revisión del plan en adelante, escribe un resumen y los archivos de los resultados de las tareas. En un proyecto vinculado el resumen va a .pocketcode/office/session-<id>.md, para no pisar tu README.md; si no, es el README.md del proyecto. Después el icono se vuelve un check verde y no sale ningún mensaje.
• No lo necesitas para conservar los archivos: ya están en el proyecto (con Preguntar, salvo los que aún esperan tu aprobación).
• Guardar escribe el código que los agentes dejaron en los resultados de las tareas, nunca su informe encima de un archivo: un bloque con path= va a esa ruta, el primer bloque de código de una tarea va a sus archivos objetivo, y un resultado sin bloque de código se escribe en tasks/<título>.md, así que los archivos objetivo de la tarea no se tocan.

Pausa, cierre y recuperación

• Cada tarea terminada se guarda en el dispositivo, así que una oficina sobrevive a un reinicio con su trabajo terminado.
• Si la app se cierra mientras una oficina trabaja, ábrela desde Mis Oficinas: vuelve en pausa, con el mensaje «This office was interrupted when the app closed (X/Y tasks done). It's paused — tap Resume to continue.», y pulsas Reanudar.
• Tras cada sprint el Office guarda también un punto de control de la sesión, pero nada en la app restaura a partir de él.

No puedes, y por qué

• Ver un diff, aceptar o rechazar un archivo, deshacer lo que escribió el Office o listar los archivos que tocó: el motor guarda un registro privado de qué agente cambió qué, pero ninguna pantalla lo enseña.Aún no
• Restaurar una oficina desde sus puntos de control: se guardan tras cada sprint, pero nada en la app los usa. La recuperación funciona con Mis Oficinas y Reanudar.Aún no
• Hacer que un agente escriba fuera de la carpeta de trabajo: las rutas se comprueban contra la ubicación real de la carpeta.A propósito

Privacidad y coste

AI Office envía el contenido de tu proyecto al proveedor de IA que elegiste, directamente desde tu dispositivo: PocketCode no pone ningún servicio de IA en medio. Trata el encargo y los archivos que dejas leer a los agentes como cosas que tu proveedor va a procesar.

Qué va al proveedor

• Tu encargo, tus respuestas a las preguntas, el plan y las tareas, en las llamadas que los necesitan.
• El contexto de cada tarea: los resultados anteriores (cada uno recortado a 1.500 caracteres), los archivos que el agente lee con sus herramientas y lo que imprimen sus comandos y, con un proyecto vinculado, su ruta, su stack y hasta 60 nombres de archivo.
• El archivo de instrucciones del proyecto, si lo tiene (sus primeros 4.000 caracteres).
• Con Analizar: los manifiestos y la documentación del proyecto más hasta 17 archivos de código, cada uno recortado a 2.000 caracteres.
• Lecciones y memorias: hasta 10 lecciones de la sesión, hasta 8 memorias relevantes por tarea y hasta 12 memorias de las últimas 5 sesiones del mismo proyecto vinculado.
• La primera vez que usas cada proveedor, el Office necesita que aceptes su aviso de datos, el mismo que muestra AI Chat. Se pregunta una vez por proveedor y cuenta, y no se envía nada a un proveedor que no hayas aceptado.
• El icono de bandera en los mensajes de IA, los artefactos y los post-mortems abre Reportar respuesta: eliges un motivo (abuso o explotación sexual infantil, odio o acoso, violencia, contenido sexual, instrucciones ilegales o dañinas, u otra cosa) y Enviar reporte lo envía a PocketCode.

Qué se queda en tu dispositivo

• Cada oficina se guarda en el almacenamiento privado de la app tras cada tarea terminada: el encargo, el plan y las tareas con sus resultados, los últimos 200 mensajes del chat, las memorias, los artefactos, la Config y la ruta del proyecto vinculado. Eliminar una oficina desde Mis Oficinas la quita de la lista y de la base de datos.
• Los puntos de control de los sprints son archivos JSON en el almacenamiento privado de la app.

Cuánto cuesta

AI Office gasta la cuota o la factura de tu propio proveedor. PocketCode no vende créditos de IA y no muestra ningún importe en dinero: los únicos números que ves son recuentos de tokens, siempre una estimación (~N tokens (est.)).

• No puedes fijar un límite de tokens ni de tiempo. Lo que acota el gasto: Pausar y Cancelar Sesión, Reintentos máx. por tarea, Máximo de sprints, un equipo más pequeño, el Modo Rápido en proyectos simples y la pausa automática tras dos tareas fallidas seguidas.
• Cada llamada tiene un tiempo máximo de 4 minutos. Tras un fallo se vuelve a intentar una vez y después con otro proveedor conectado, salvo que el problema sea un aviso de datos sin aceptar.
• La estimación aparece en la cabecera, en la hoja del agente, en la tira del equipo (~1.2k), en Rendimiento de Agentes y en la tarjeta de cada oficina de Mis Oficinas (~Xk tok).

Las llamadas que hace una oficina