AI Office

O que é e como abrir

O AI Office abre como uma janela em tela cheia acima de todo o app. Ele não é uma das cinco páginas do pager principal. Não tem atalho de teclado, entrada na paleta de comandos nem deep link: as quatro rotas abaixo são as únicas, e as quatro passam pela mesma verificação de Pro.

Formas de abrir

Pro, verificado uma vez na porta

• O AI Office é um módulo Pro por inteiro. No Free, todas as rotas acima mostram o paywall Pro (o Office aparece em IA que trabalha sozinha, ao lado de Cortex, Swarmcode e do AI Designer) e o Office não abre.
• Uma vez dentro, nada mais é limitado por plano, exceto o número de projetos (veja Free e Pro). Os provedores de IA não fazem parte do plano: você traz sua própria chave.

Como a janela se comporta

• Fechar a janela não pausa um escritório em execução. Ele continua trabalhando, protegido por uma notificação em primeiro plano, até terminar ou até você pausar.
• Voltar (o gesto do sistema): em Welcome fecha o Office; em Meus Escritórios, no Lobby e em Atividade vai para Welcome (dentro do Lobby, primeiro volta uma página); em Analisar, Revisão do plano e Provedor de IA volta ao Lobby; em Planejamento cancela o planejamento e volta ao Lobby; em Quadro, Chat e Resultados vai para Atividade.

A equipe: oito papéis

O Office tem oito papéis. Eles não são oito agentes fixos: você escolhe a equipe, de um agente até os oito, e há um agente por papel selecionado. A tabela diz o que cada papel faz no app.

Sua equipe

• O Lobby lista os oito papéis com um interruptor cada. O Gerente de Projeto tem um cadeado (Obrigatório) e não pode ser desligado, então uma equipe tem de 1 a 8 agentes.
• A equipe padrão tem cinco: Gerente de Projeto, Arquiteto, Desenvolvedor Frontend, Desenvolvedor Backend e Engenheiro QA. Cada template sugere sua própria equipe e sempre adiciona o Gerente de Projeto.
• As revisões só existem se a equipe tiver um Engenheiro QA: sem ele, as tarefas são aceitas sem revisão.
• O Orquestrador que você vê no Chat e o pesquisador de projeto por trás de Analisar não são papéis: são funções do motor do Office.

Qual modelo cada papel usa

• Você não escolhe um modelo por papel. Quando pressiona Iniciar Escritório, o Office escolhe, para cada papel, o melhor modelo entre os provedores que têm chave, e o mostra no cartão do papel na página da equipe, na folha do agente em Atividade e em Desempenho dos Agentes em Resultados.
• Ele agrupa os papéis em três níveis: os modelos mais fortes para Gerente de Projeto, Arquiteto e Engenheiro QA; modelos rápidos e capazes para Desenvolvedor Frontend, Desenvolvedor Backend e Engenheiro de Dados; os mais baratos e rápidos para DevOps e Redator Técnico.
• Se sessões anteriores no mesmo projeto vinculado mostram outro provedor claramente melhor em um papel (pelo menos 3 amostras e mais de 15 pontos de sucesso), ele troca esse papel para esse provedor.

Você não pode, e por quê

• Escolher o modelo, o provedor ou o nível de raciocínio de um único papel: o Office não tem controle para isso, e a escolha em Provedor de IA e modelo também não o define.Ainda não
• Desligar o Gerente de Projeto: ele está sempre na equipe.De propósito
• Fazer deploy de dentro do Office: ele não está conectado ao Backend Manager, então não há etapa nem botão de deploy. Faça o deploy pelo Backend Manager.De propósito
• Usar o Office sem nenhum provedor de IA conectado: sem chave, a primeira chamada falha e o Lobby mostra “O planejamento falhou — verifique o log do chat para detalhes”.Precisa de rede

Welcome e Meus Escritórios

Welcome é a primeira tela do Office. Daqui você abre seus escritórios ou inicia uma nova sessão.

Welcome

Duas ações e três blocos informativos em Recursos. Na horizontal, os blocos informativos ficam à esquerda e as ações à direita; na vertical, tudo fica empilhado em uma coluna.

Meus Escritórios

Os escritórios são as sessões que você iniciou: a atual e as anteriores. Três contadores no topo: Total, Em execução (escritórios executando agora) e Concluído (finalizados). Um cartão mostra o nome, o estado, as primeiras linhas do briefing, uma barra com as tarefas concluídas e chips com o número de agentes, o número de sprints, a data, os tokens estimados (~Xk tok) e Projeto vinculado. O estado tem sete rótulos; um escritório aguardando a revisão de um sprint e um cancelado aparecem como Configuração.

O Lobby: briefing, equipe e Config

O Lobby é um assistente de duas páginas. A página 1 é O que vamos construir hoje?; a página 2 é Sua equipe, e a folha Config abre a partir dela. Voltar leva da página 2 à página 1.

Página 1: o que construir

Uma caixa de texto grande, três chips de exemplo, um carrossel de templates e, se você já tem projetos, uma forma de construir sobre um deles. “Descreva com suas palavras. Sua equipe cuida do resto.”

Página 2: sua equipe

Sua equipe tem o nome do projeto, um cartão por papel e o botão Ajustar detalhes.

A folha Config

Ajustar detalhes abre uma folha chamada Config. Ela só existe no Lobby: depois de pressionar Iniciar Escritório, você não pode mudar nada dela. Estes são seus controles, em ordem.

O que os controles realmente fazem

• O Modo Rápido sempre pula as perguntas de esclarecimento, pede ao planejador de 3 a 5 tarefas de 2 a 4 arquivos cada e eleva Tarefas paralelas para 2 se estava em 1. Ele aprova o plano automaticamente e pula a revisão de QA somente quando o projeto é avaliado como Trivial ou Simple; a partir de Moderate você ainda revisa o plano e o QA ainda revisa.
• Habilitar revisões QA: só existe revisão se a equipe tiver um Engenheiro QA. Se a própria chamada de revisão falha, a tarefa é aceita sem revisão e o chat avisa. Na última tentativa permitida, uma saída com mais de 200 caracteres é aprovada automaticamente.
• Tool-calling nativo: ligado, os agentes usam as chamadas de ferramenta nativas do provedor, com as mesmas barreiras de permissão do AI Chat e os arquivos confinados à pasta de trabalho. Desligado, usam o protocolo de texto mais antigo, com uma lista fixa de ferramentas por papel e nível de risco e até 8 rodadas de ferramentas por tarefa.
• Tarefas paralelas: o controle vai até 4, mas o Office executa no máximo 3 tarefas por vez, e apenas tarefas que o plano marca como paralelas e que declaram seus arquivos. O workflow Feature Delivery, o SPARC e o Auto (que por padrão usa Feature Delivery) elevam o mínimo para 2, o que desliga o Best-of-N.
• Máximo de sprints: o planejador recebe o pedido de no máximo o menor valor entre Máximo de sprints e os sprints sugeridos mais um. A sugestão é 1 para Trivial e Simple, 2 para Moderate, 3 para Complex e 5 para Massive.
• Tentativas Best-of-N: para cada tarefa de código, faz N tentativas, uma após a outra, e fica com a que passa na verificação local, então custa cerca de N vezes os tokens nessas tarefas. Só funciona com Tarefas paralelas em 1 e tool-calling nativo ligado, na primeira tentativa de cada tarefa.
• Adversarial review: um painel de N juízes céticos (1 a 5, com quórum e até 3 juízes ao mesmo tempo) revisa cada tarefa no lugar do único Engenheiro QA. Exige revisões de QA ligadas e um Engenheiro QA na equipe, e multiplica as chamadas. Tudo nesse interruptor aparece em inglês.
• Sistema de design, Playbook e Workflow de trabalho moldam os prompts dos agentes; não adicionam ferramentas nem etapas de aprovação.

Você não pode, e por quê

• Escolher o SPARC: o Office tem esse playbook, mas o seletor mostra oito cartões e o SPARC não é um deles. O Auto só o ativa se o seu briefing contiver “sparc”, “specification pseudocode” ou “pseudocode architecture”.Ainda não
• Fazer Auto-aprovar planos ter algum efeito: nada no app o lê. Para pular a revisão do plano, use o Modo Rápido, que funciona apenas em projetos Trivial e Simple.Ainda não
• Definir um limite de tokens, um limite de tempo, uma estratégia de testes ou o modo estrito de ferramentas: existem nas configurações do Office, mas nenhum controle os mostra.Ainda não
• Mudar a Config de um escritório depois de pressionar Iniciar Escritório: a folha só existe no Lobby.De propósito

Workflow de trabalho: como o trabalho é planejado

Cada cartão diz ao Gerente de Projeto como planejar e encaminhar o trabalho: molda o prompt de planejamento e qual agente recebe qual tarefa. Não adiciona ferramentas nem etapas de aprovação próprias.

Playbook: o nível de qualidade

Um playbook é um bloco de regras acrescentado ao prompt de cada agente. Nomes e descrições são texto fixo em inglês.

Planejamento e Revisão do plano

Depois de Iniciar Escritório, o Gerente de Projeto planeja. A tela Criando Seu Plano mostra três linhas fixas (Montando agentes…, Analisando requisitos…, Criando divisão de tarefas…) que não são uma barra de progresso real, e um botão Cancelar; Voltar também cancela e retorna ao Lobby.

O que o planejamento faz

1. 1Escolhe o workflow de trabalho (com Auto, a partir das palavras do seu briefing).
2. 2Faz as perguntas de esclarecimento do Gerente de Projeto, a menos que o Modo Rápido esteja ligado.
3. 3Avalia a complexidade de 1 a 5: Trivial, Simple, Moderate, Complex ou Massive. Se a chamada de avaliação falha, assume Moderate.
4. 4Pede ao modelo o plano em sprints e tarefas, cada uma com título, descrição, papel, prioridade, dependências, arquivos, skills, critérios de aceitação, risco, esforço e se pode executar em paralelo. O plano é escrito no idioma do seu dispositivo.
5. 5Entrega cada tarefa ao agente da sua equipe mais adequado e, se a equipe tem um Engenheiro QA, a um Engenheiro QA diferente do responsável como revisor.
6. 6Termina na Revisão do plano. Com o Modo Rápido ligado e um projeto avaliado como Trivial ou Simple, começa a trabalhar direto. Se o plano não puder ser lido, cria uma única tarefa genérica e avisa no chat.

Perguntas rápidas

A menos que o Modo Rápido esteja ligado, o Gerente de Projeto primeiro faz de 3 a 5 perguntas, cada uma com 3 ou 4 opções de resposta, no idioma do seu dispositivo. “Responda para ajudar o PM a montar um plano melhor.”

Revisar Plano

A tela mostra a complexidade (um chip em inglês: TRIVIAL, SIMPLE, MODERATE, COMPLEX ou MASSIVE), a Estratégia que o Gerente de Projeto explica e os Sprints, cada um com seu número de tarefas.

Aprovações e complexidade

• Aprovar o plano é a confirmação do próprio Office. Em projetos avaliados como Complex ou Massive há outra entre os sprints: o escritório para em Revisão do Sprint e a barra inferior mostra Pular Sprint e Aprovar.
• O Modo Rápido só pula a revisão do plano em projetos avaliados como Trivial ou Simple. Auto-aprovar planos não faz nada.
• A partir de Moderate, tarefas estimadas como Large ou Extra Large são divididas em subtarefas menores enquanto o escritório trabalha. Projetos Complex e Massive seguram as tarefas de código até as tarefas de arquitetura terminarem.

Atividade: o escritório trabalhando

Com o plano aprovado, o escritório trabalha em quatro telas entre as quais você pode deslizar ou que abre com os quatro ícones da barra inferior: Atividade, Quadro, Chat e Resultados. O cabeçalho mostra o nome do projeto, um ponto que pulsa enquanto o escritório planeja ou trabalha e uma linha com o sprint, quantos agentes estão trabalhando (N trabalhando) e os tokens estimados (~N tokens (est.)). O ícone Salvar fica à direita (veja O que ele grava no seu projeto). Atividade é a casa de um escritório em execução.

A barra de ações

Pausar, retomar e o que eles preservam

• Pausar para na hora: a chamada à IA em andamento é descartada e seu resultado parcial se perde, e uma tarefa em andamento volta para A Fazer e recomeça quando você retoma. Os arquivos já gravados ficam como estão.
• Retomar relança o plano de onde estava. Repetir falhas devolve as tarefas que falharam (com as tentativas zeradas) e as bloqueadas para A Fazer e retoma. Pular Sprint marca o sprint como pulado, bloqueia suas tarefas não concluídas e passa ao seguinte.
• Quando o trabalho termina: se todas as tarefas estão concluídas, o escritório fica Concluído; se algumas foram concluídas e outras falharam ou estão bloqueadas, ele para Pausado com uma mensagem como “N/M tasks completed, N failed, N blocked”, para você tentar de novo, re-planejar ou salvar o que tem; se nenhuma teve sucesso, fica Falhou.
• Uma tarefa que falha é tentada de novo até Tentativas máx. por tarefa vezes, esperando 3, 6, 12 e depois 24 segundos antes de cada nova tentativa. Quando duas tarefas seguidas falham, o escritório pausa sozinho (“⚠ N consecutive failures detected. Pausing to reassess the plan…”). Ele também pausa quando um agente faz uma pergunta a você e quando a pasta do projeto está faltando e seu plano não tem espaço para outro projeto.

As aprovações de ferramentas são decididas no AI Chat

• O Office não tem um diálogo de aprovação próprio para ferramentas. O que os agentes fazem com ferramentas passa pelas mesmas barreiras do AI Chat: as ferramentas que você negou em Permissões de ferramentas IA (Configurações → IA), a verificação de quão arriscado é cada comando de terminal, o nível de acesso do chat (Sem ferramentas, Só leitura, Perguntar, Editar sozinho, Acesso total) e a aprovação de qualquer coisa que saia do dispositivo, como um git push, um curl ou um ssh.
• O que precisa do seu OK vai para uma fila e o agente continua trabalhando: ele é informado de que a ação não foi executada e ficou na fila. Os cartões aparecem no AI Chat, e o painel Atividade do chat lista o AI Office em Esperam por você · N. Aprove ou negue lá: o Office nunca pergunta dentro das suas próprias telas.
• Com o nível padrão, Editar sozinho, as edições de arquivos executam sem perguntar, mas executar comandos e qualquer coisa que saia do dispositivo esperam seu OK. Com Perguntar, gravar arquivos também pergunta, inclusive quando o Office grava os blocos de código de uma resposta ao fim de uma tarefa: cada arquivo espera na mesma fila e não é gravado até você aprovar. Com Só leitura ou Sem ferramentas, as ferramentas dos agentes são recusadas e o Office também não grava arquivos por conta própria.

O que ele grava no seu projeto

Esta é a seção que mais importa: o Office grava em um projeto real seu enquanto trabalha.

Onde ele grava

• Com um projeto vinculado, trabalha na pasta do próprio projeto e modifica os arquivos que já existem; ele é instruído a estender o que existe e não a criar um projeto novo do zero.
• Sem um, cria uma pasta com o nome do projeto dentro da pasta projects/ do app, e essa pasta passa a ser mais um projeto na sua lista. Se já existe uma pasta com esse nome, o Office trabalha nela. O nome vem das três primeiras palavras do briefing, a menos que você edite Nome do Projeto.
• No início o chat diz onde vai gravar: “Working in the linked project: …” ou “No project linked — the team will work in a new project: …”.
• Os agentes não conseguem gravar fora dessa pasta: caminhos com .. ou caminhos absolutos são descartados, e um link simbólico que aponta para fora da pasta é recusado.

Como os arquivos são gravados

• Enquanto uma tarefa executa (tool-calling nativo, o padrão), os agentes criam e editam arquivos e executam comandos com as ferramentas do app, confinados à pasta de trabalho.
• Quando uma tarefa termina, o Office também grava os arquivos encontrados na resposta do agente (blocos de código com um path=, ou o primeiro bloco de código nos arquivos de destino da tarefa). Com Perguntar, cada arquivo passa pela mesma fila de aprovações das ferramentas dos agentes: fica estacionado no AI Chat e não é gravado até você aprovar. Com Editar sozinho ou mais, é gravado sem perguntar; com o nível de acesso Só leitura ou Sem ferramentas essa etapa é pulada e o Office não grava nada por conta própria.
• Uma revisão de QA lê texto. Além dela, o Office verifica o trabalho localmente: o HTML e o CSS do Desenvolvedor Frontend passam por uma verificação de estrutura, e um script que o agente escreveu (Python, JavaScript, Ruby, PHP e mais alguns) é executado no seu dispositivo com os mesmos runners do botão Run do editor, por no máximo 30 segundos. Uma falha real devolve a tarefa para outra tentativa (somente na primeira tentativa, com as revisões de QA ligadas).
• Uma verificação de honestidade separada compara o que um relatório diz ter executado com os comandos que realmente foram executados. Uma tarefa que se gaba de uma execução de testes que ninguém iniciou é devolvida ou, sem tentativas restantes (ou se o agente não tem como executar comandos), termina marcada como Not verified by PocketCode.

O que ele pergunta a você

• Sua aprovação do plano e de cada sprint em projetos Complex e Massive. É a única confirmação do próprio Office.
• O aviso de dados do seu provedor de IA, uma vez por provedor e conta: o mesmo aviso e o mesmo registro do AI Chat. Se você recusar, nada é enviado.
• Aprovações de ferramentas, que são decididas no AI Chat (veja Atividade).

O ícone Salvar

• Salvar, no cabeçalho a partir da Revisão do plano, grava um resumo e os arquivos dos resultados das tarefas. Em um projeto vinculado, o resumo vai para .pocketcode/office/session-<id>.md, para não sobrescrever seu README.md; caso contrário, é o README.md do projeto. Depois, o ícone vira um visto verde e nenhuma mensagem é exibida.
• Você não precisa dele para manter os arquivos: eles já estão no projeto (com Perguntar, exceto os que ainda esperam a sua aprovação).
• Salvar grava o código que os agentes deixaram nos resultados das tarefas, nunca o relatório deles em cima de um arquivo: um bloco com path= vai para esse caminho, o primeiro bloco de código de uma tarefa vai para os arquivos de destino dela, e um resultado sem bloco de código é gravado em tasks/<title>.md, então os arquivos de destino da tarefa não são tocados.

Pausa, fechamento e recuperação

• Cada tarefa concluída é salva no dispositivo, então um escritório sobrevive a uma reinicialização com o trabalho que já terminou.
• Se o app fecha enquanto um escritório executa, abra-o em Meus Escritórios: ele volta pausado, com a mensagem “This office was interrupted when the app closed (X/Y tasks done). It's paused — tap Resume to continue.”, e você pressiona Retomar.
• Depois de cada sprint, o Office também guarda um checkpoint da sessão, mas nada no app restaura a partir dele.

Você não pode, e por quê

• Ver um diff, aceitar ou rejeitar um arquivo, desfazer o que o Office gravou ou listar os arquivos que ele tocou: o motor guarda um registro privado de qual agente mudou o quê, mas nenhuma tela o mostra.Ainda não
• Restaurar um escritório a partir dos seus checkpoints: eles são salvos depois de cada sprint, mas nada no app os usa. A recuperação funciona por Meus Escritórios e Retomar.Ainda não
• Fazer um agente gravar fora da pasta de trabalho: os caminhos são conferidos contra a localização real da pasta.De propósito

Privacidade e custo

O AI Office envia o conteúdo do seu projeto ao provedor de IA que você escolheu, direto do seu dispositivo: o PocketCode não coloca nenhum serviço de IA no meio. Trate o briefing e os arquivos que você deixa os agentes lerem como coisas que seu provedor vai processar.

O que vai para o provedor

• Seu briefing, suas respostas às perguntas, o plano e as tarefas, nas chamadas que precisam deles.
• O contexto de cada tarefa: os resultados anteriores (cada um cortado em 1.500 caracteres), os arquivos que o agente lê com suas ferramentas e o que seus comandos imprimem e, com um projeto vinculado, o caminho, a stack e até 60 nomes de arquivos dele.
• O arquivo de instruções do projeto, se ele tiver um (seus primeiros 4.000 caracteres).
• Com Analisar: os manifestos e a documentação do projeto mais até 17 arquivos-fonte, cada um cortado em 2.000 caracteres.
• Lições e memórias: até 10 lições da sessão, até 8 memórias relevantes por tarefa e até 12 memórias das últimas 5 sessões do mesmo projeto vinculado.
• Na primeira vez que você usa cada provedor, o Office precisa da sua aceitação do aviso de dados dele, o mesmo que o AI Chat mostra. É pedido uma vez por provedor e conta, e nada é enviado a um provedor que você não aceitou.
• O ícone de bandeira em mensagens de IA, artefatos e post-mortems abre Denunciar resposta: você escolhe um motivo (abuso ou exploração sexual de menores, ódio ou assédio, violência, conteúdo sexual, instruções ilegais ou prejudiciais, ou outra coisa) e Enviar denúncia o envia ao PocketCode.

O que fica no seu dispositivo

• Cada escritório é salvo no armazenamento privado do app depois de cada tarefa concluída: o briefing, o plano e as tarefas com seus resultados, as últimas 200 mensagens do chat, as memórias, os artefatos, a Config e o caminho do projeto vinculado. Excluir um escritório em Meus Escritórios o remove da lista e do banco de dados.
• Os checkpoints de sprint são arquivos JSON no armazenamento privado do app.

Quanto custa

O AI Office gasta a cota ou a fatura do seu próprio provedor. O PocketCode não vende créditos de IA e não mostra nenhum valor em dinheiro: os únicos números que você vê são contagens de tokens, sempre uma estimativa (~N tokens (est.)).

• Você não pode definir um limite de tokens ou de tempo. O que limita o gasto: Pausar e Cancelar Sessão, Tentativas máx. por tarefa, Máximo de sprints, uma equipe menor, o Modo Rápido em projetos simples e a pausa automática depois de duas tarefas seguidas com falha.
• Cada chamada tem um timeout de 4 minutos. Depois de uma falha, é tentada mais uma vez e depois com outro provedor conectado, a menos que o problema seja um aviso de dados ausente.
• A estimativa aparece no cabeçalho, na folha do agente, na faixa da equipe (~1.2k), em Desempenho dos Agentes e no cartão de cada escritório em Meus Escritórios (~Xk tok).

As chamadas que um escritório faz