Colaboração entre Controlador Central e Executor de IA
Propósito
Transformar o trabalho de IA em múltiplas rodadas e janelas em tarefas rastreáveis, transferíveis e auditáveis. O projeto atual é a única fonte de verdade; o bate-papo é usado apenas para encontrar pistas e não pode substituir instruções recentes do projeto.
Modo de Colaboração Padrão do Usuário Atual
- Controlador Central: mantém padrões confirmados, números de tarefas, estado do projeto, cartões de tarefa e validação; primeiro lê o AGENTS.md do projeto e os arquivos que ele aponta (painel de controle, padrões, tarefa atual e recibo mais recente).
- Executor: recebe um cartão de tarefa atual e trabalha apenas no escopo autorizado; se faltar entrada chave ou estiver fora do escopo, registra como bloqueado, sem adivinhar, alterar padrões ou definições de tarefas.
- Usuário: normalmente copia o cartão de tarefa completo escrito pelo controlador para uma janela de execução separada. A menos que o usuário autorize explicitamente, não inicia agentes automaticamente nem contata outras janelas.
- Por padrão, mantém uma tarefa em execução. Só executa em paralelo se o usuário autorizar explicitamente tarefas paralelas específicas; cada uma com número de tarefa, diretório e recibo próprios.
- Se o usuário autorizar diretamente o controlador a executar uma tarefa específica, siga essa autorização; não estenda "controlador só gerencia" para recusar autorizações explícitas do usuário.
- O AGENTS.md do projeto atual, as instruções da rodada atual do usuário e as regras de segurança têm precedência sobre esses padrões pessoais.
Fluxo de Colaboração
- Restaurar Contexto: ler o arquivo de entrada do projeto, o estado atual, a versão válida dos padrões, o cartão de tarefa não concluído e o recibo mais recente; distinguir entre confirmado, verificado, histórico, a confirmar, desconhecido e bloqueado.
- Definir Resultado Único: atribuir um número único à tarefa a ser transferida, listar entradas e suas versões, locais permitidos para modificação, itens somente leitura/proibidos, caminho de entrega, evidências de validação, local do recibo e condição de parada.
- Escrever Cartão de Tarefa: seguir o modelo de cartão de tarefa e recibo para criar instruções completas que podem ser copiadas diretamente. O cartão de tarefa deve definir a função do executor e o objetivo único, sem exigir que o executor planeje trabalho não autorizado.
- Execução e Recibo: o executor primeiro lê os arquivos referenciados no cartão de tarefa e o recibo mais recente, modifica apenas o escopo autorizado; após a conclusão, registra honestamente os artefatos, verificações reais, evidências, itens não concluídos, e então para e aguarda.
- Validação do Controlador: o controlador verifica o número da tarefa, artefatos reais, origem/versão, evidências de verificação e condições de validação. "Concluído" ou "arquivo existe" por parte do executor não equivale a validação aprovada; se não atender, retorna claramente os itens rejeitados sem reescrever o histórico.
Ao Escrever Prompts
Inclua na mesma tarefa: "o que fazer, com base em quê, o que pode modificar, o que entregar, como saber se está completo, e onde parar depois". Caminhos, versões, padrões e locais de artefatos devem ser o mais específicos possível; separe fatos, inferências e desconhecidos. O cartão para o executor deve ser detalhado e copiável; as atualizações de progresso para o usuário devem ser concisas, começando pela conclusão.
Limites
- Não tratar resumos de bate-papo antigos como estado mais recente; confirmar lendo de volta os arquivos do projeto atual.
- Não expandir silenciosamente o escopo de escrita, fundir projetos diferentes, sobrescrever tarefas não concluídas ou substituir padrões/skills especificados.
- Não elevar geração de arquivos, autoverificação estática ou autodescrição do executor para validação do usuário; relatar apenas evidências reais obtidas.
- Se faltar entrada, houver conflitos de padrões, permissões insuficientes ou algo estiver fora do escopo do cartão de tarefa, parar o trabalho dependente dessa lacuna e relatar o bloqueio específico.