RespostasPublicado13 fontes
V4: como controlar arquivos temporários sem abrir mão de testes e documentação úteis
A proposta é reduzir artefatos sem valor duradouro, não eliminar testes de regressão nem concentrar toda a documentação em um único arquivo. O Overalls usa máquinas de desenvolvimento Firecracker persistentes e também é descrito como plataforma para tarefas em VMs temporárias; as fontes não esclarecem como os ciclos...
Publicado porImagens geradas com GPT Image 2
Resposta de pesquisa
Principais conclusões
- A proposta é reduzir artefatos sem valor duradouro, não eliminar testes de regressão nem concentrar toda a documentação em um único arquivo.
- O Overalls usa máquinas de desenvolvimento Firecracker persistentes e também é descrito como plataforma para tarefas em VMs temporárias; as fontes não esclarecem como os ciclos de vida se relacionam.
- No V4, testes e documentos já têm alguma organização. O principal ponto a completar são as regras sobre criação, versionamento, distribuição e retenção dos arquivos.
- A recomendação é diferenciar testes permanentes, validações pontuais e evidências de execução, além de manter cada documento ligado à sua função.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/Ct73VtXRvYVtxLOrIWogs8h8njx2/images/14A07FDFEAF32EEE32FC/0F2CDBA675F3E1798D02.png)
Prompt de IA
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这两个痛点应该纳入 V4 的“产物背压”，但治理目标应是减少无价值产物、隔离临时材料、控制提交与分发，而不是取消长期测试或把所有文档合并。前面回答中的部分来源编号没有对应真实检索证据，相关归因撤回；以下仅依据本次真实检索和已经返回的仓库读取结果。\n\n 1.. Topic tags: general web, llm, agents, ai, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbna
O V4 pode tratar o excesso de arquivos com uma política de controle de artefatos: criar menos materiais sem utilidade duradoura, manter os temporários separados e definir o que entra no repositório ou na distribuição. Isso não significa abandonar testes importantes nem colocar toda a documentação em um arquivo só.
O que as fontes permitem afirmar sobre o Overalls
O sistema mencionado provavelmente é o Overalls. Em um artigo, Geoffrey Huntley diz que o projeto se chamava loom e descreve o uso de máquinas Firecracker temporárias para despachar tarefas de programação feitas por agentes.10
Já a documentação oficial apresenta o Overalls como uma plataforma autogerenciada de máquinas de desenvolvimento e agentes de IA. Cada máquina é uma microVM Firecracker persistente, com NixOS, Ubuntu ou Windows.12
As fontes descrevem ambientes temporários para tarefas e máquinas de desenvolvimento persistentes, mas não explicam por completo como esses ciclos de vida se conectam. Portanto, não dá para concluir que o Overalls apaga automaticamente o repositório ao terminar uma tarefa. Também não foi possível localizar a publicação no X mencionada nem verificar a imagem. A alegação de que o sistema organiza testes temporários e controla a expansão da documentação não está confirmada pelas fontes disponíveis.
A ideia que pode ser aproveitada com cautela é separar ambientes de execução. Isso, por si só, não define como organizar testes, o que versionar ou quais documentos distribuir.
No V4, a lacuna está nas regras de ciclo de vida
As evidências estáticas do repositório indicam que já há algumas convenções:
- Testes de longo prazo: o arquivo
ci.ymlreúne testes de contrato e, em etapas posteriores, verificações de proteção de ativos e regressão de distribuição. Removê-los sem análise pode quebrar o contrato de validação existente. A presença dessas etapas na configuração não significa que o CI tenha sido executado ou aprovado nesta análise. - Funções da documentação:
bmad-core.mddistingue análise, ADRs, planos, especificações e bases factuais. Também orienta a não criar um caminho novo por conta própria quando não estiver claro onde um documento deve ficar. - Arquivos temporários: o
.gitignorecobre alguns diretórios de execução, ambientes isolados e arquivos temporários, mas não define por completo quando rascunhos e evidências de validação devem ser mantidos. A configuração de ignorados, sozinha, tampouco confirma quais arquivos estão sendo versionados. - Distribuição:
collect_source()percorre os arquivos comuns do código-fonte do pacote e os mapeia para o diretório de plugins. Verificar se os arquivos obrigatórios estão presentes não equivale a ter uma lista de permissões de distribuição. Assim, materiais temporários colocados nessa árvore podem acabar incluídos; isso é um risco identificado na configuração, não a comprovação de que já aconteceu.
A prioridade, portanto, é completar as regras sobre criação, versionamento, distribuição e retenção, em vez de inventar uma segunda estrutura de diretórios.
Testes temporários não são a mesma coisa que testes permanentes
Mais arquivos de teste não significam necessariamente que o código-fonte esteja desorganizado. O critério não deve ser apagar ou mover tudo o que tiver “test” no nome.
| Tipo de material | Destino sugerido | Orientação para versionamento e distribuição |
|---|---|---|
| Testes unitários permanentes, regressões de defeitos e testes de contrato | Estrutura de testes já adotada pelo projeto | Em geral, manter no controle de versão; decidir a distribuição conforme o uso do pacote |
| Diagnósticos pontuais e scripts de validação temporários | Área temporária autorizada para a tarefa | Por padrão, não versionar nem distribuir |
| Logs, dados de cobertura e relatórios gerados | Área de evidências de execução | Guardar conforme os critérios de aceite e retenção; não incluir automaticamente no histórico do código |
| Casos importantes e reproduzíveis | Promover a ativo permanente de teste após revisão | Preservar seu valor de regressão, em vez de deixá-los apenas na área temporária |
Três verificações ajudam a evitar arquivos desnecessários:
- Antes de criar: é possível estender um teste existente? O novo arquivo cobre um comportamento distinto ou apenas repete uma verificação?
- Antes de versionar: o material é um ativo duradouro do projeto? Ele contém caminhos locais, credenciais ou conteúdo de depuração pontual?
- Antes de distribuir: o arquivo faz parte do que deve ser entregue? Estar no repositório não significa que precise ser instalado junto com o produto.
A estrutura precisa continuar compatível com cada linguagem. A documentação oficial do Go, por exemplo, distingue arquivos de teste do próprio pacote e de um pacote externo; por isso, não é seguro impor a mesma organização a todas as linguagens.13 Um diretório de testes centralizado pode ser avaliado em Python. Em Go, mudanças devem considerar acesso ao pacote, descoberta dos testes e dependências antes de reorganizar arquivos.
Também é importante identificar o problema específico: se a preocupação é o conteúdo entregue a quem instala o pacote, a solução está nos limites da distribuição; se são arquivos temporários entrando no histórico do código, está no versionamento; se é a navegação pelos fontes, pode estar na organização ou na forma de exibição. São questões diferentes.
Documentos: organizar por função, não por conversa
Uma política documental pode aproveitar os papéis já definidos, sem gerar um novo arquivo para cada rodada de trabalho:
- Análise da sessão: fica, por padrão, na entrega da própria sessão, sem ser salva em disco.
analysis/: guarda análises, evidências, comparações e pontos ainda desconhecidos quando houver aprovação; não deve virar uma área de rascunhos do dia a dia.adrs/: registra decisões relevantes e seus motivos, sem copiar integralmente relatórios de pesquisa ou históricos de execução.pending_implementation_plan.md: reúne objetivo, autorização, etapas, dependências e critérios de aceite, sem ser transformado em um registro contínuo de atividades. Um plano ativo não deve ser substituído por causa desta proposta.scratch/: pode ser avaliado como área temporária comum. Sua existência, porém, não autoriza gravar, apagar ou executar arquivos sem permissão.verification/: pode guardar evidências brutas necessárias, com regras próprias de retenção e versionamento; não é preciso manter indefinidamente toda saída repetida.
Materiais de implantação também devem ser classificados pela função: um guia operacional permanente é documentação de manutenção; o comprovante de uma implantação específica é evidência de execução. O título conter a palavra “implantação” não basta para justificar um diretório separado. Qualquer mudança de caminho deve preservar referências e tarefas pendentes, sem mover ou apagar o histórico indiscriminadamente.
Para evitar que um documento isolado cresça sem controle:
- Separe por tema ou decisão independente, não por rodada de conversa.
- Mantenha análise, ADR e plano com funções distintas, conectando-os por referências em vez de duplicar o conteúdo.
- Ao retomar uma tarefa, carregue o contrato atual e os trechos de evidência pertinentes, sem reapresentar todo o histórico.
- Em resumos, diferencie fatos, inferências e pontos a verificar; condensar uma hipótese não a transforma em fato.
A ideia de que menos arquivos causariam mais alucinações continua sendo uma hipótese a testar, não uma relação comprovada. O primeiro passo é reduzir duplicações, conteúdo desatualizado e contexto irrelevante, sem prometer um número ideal de linhas ou um resultado que ainda não foi medido.
Uma regra mínima para o V4
Antes de criar um artefato, definir sua finalidade, onde deve ficar, se precisa ser persistente e quais são seus limites de versionamento e distribuição, além das condições para mantê-lo ou removê-lo. A regra também deve incentivar o reaproveitamento de ativos existentes, sem exigir um arquivo novo para cada validação ou documento para cada análise.
Se a proposta for autorizada para implementação, os critérios mínimos de aceite podem incluir:
- Os testes permanentes continuam sendo descobertos e executados pelo CI relevante, e regressões necessárias não se perdem durante mudanças de lugar.
- Materiais temporários não entram em commits ou pacotes de instalação sem necessidade.
- Funções e referências documentais permanecem válidas; tarefas ativas e evidências históricas não são apagadas por engano.
- Limpeza e retenção têm escopo explícito, e separar diretórios não é tratado como se fosse isolamento de segurança em tempo de execução.
Esta análise é somente leitura: nenhum arquivo foi alterado, teste foi executado, material foi limpo ou plano foi substituído. A publicação e a imagem mencionadas não foram verificadas, e as fontes não confirmam como o Overalls trata especificamente esses dois problemas. As recomendações são uma proposta condicional para o V4, não autorização para implementá-la.
Studio Global AI
Continue sua pesquisa
Esta página inclui uma resposta baseada na fonte que você pode continuar em Studio Global.
As pessoas também perguntam
Qual é a resposta curta para "V4: como controlar arquivos temporários sem abrir mão de testes e documentação úteis"?
A proposta é reduzir artefatos sem valor duradouro, não eliminar testes de regressão nem concentrar toda a documentação em um único arquivo.
Quais são os pontos-chave para validar primeiro?
A proposta é reduzir artefatos sem valor duradouro, não eliminar testes de regressão nem concentrar toda a documentação em um único arquivo. O Overalls usa máquinas de desenvolvimento Firecracker persistentes e também é descrito como plataforma para tarefas em VMs temporárias; as fontes não esclarecem como os ciclos de vida se relacionam.
O que devo fazer a seguir na prática?
No V4, testes e documentos já têm alguma organização. O principal ponto a completar são as regras sobre criação, versionamento, distribuição e retenção dos arquivos.