Add portable topics and surveys, decision approval history, execution plans, local Codex and Claude adapters, and general agent routing. Consolidate Plan and EPIC results through deterministic completion receipts, reviewed cancellation scope and recoverable reconciliation. Track the completed WRK-0001 and WRK-0002 records, protocol documentation, source manifests and delivery evidence. Validation: 117 tests including Modulith; GraalVM 25 native compilation, standalone smoke and ZIP/TAR verification on macOS ARM64; identical persisted context across JVM and native executions.
320 lines
12 KiB
Markdown
320 lines
12 KiB
Markdown
---
|
|
schemaVersion: 1
|
|
id: "WRK-0001"
|
|
title: "Definir refinamento de ideias e coordenação de agentes"
|
|
description: "O formato permanece Discussão, DEC e Plan. Dentro da Discussão, o AIE\
|
|
\ deverá organizar e catalogar ideias livres por tópicos, gerar sugestões e surveys,\
|
|
\ sugerir manter um Work contido ou abrir um EPIC, investigar as propostas e trazer\
|
|
\ resultados para avançar o refinamento. Conclusões pertinentes sustentam DECs e,\
|
|
\ quando adotadas, planos. Agentes serão configuráveis por atividade, com general\
|
|
\ para síntese e execução padrão. EPICs poderão produzir Works derivados e configurar\
|
|
\ o acompanhamento dos importantes, todos por padrão; o framework propagará conclusõ\
|
|
es e avaliará EPICs deterministicamente, informando o solicitante. Este Work discute\
|
|
\ contratos e primeiro recorte antes da implementação."
|
|
goal: "Evoluir a Discussão para organizar ideias por contexto, investigar e incorporar\
|
|
\ resultados e fundamentar decisões e planos, mantendo o formato Discussão → DEC\
|
|
\ → Plan, com agentes configuráveis e controle determinístico do protocolo."
|
|
motivation: "Usar o próprio AIE para evoluir o framework e o Zelda 1 como projeto\
|
|
\ externo de teste."
|
|
constraints:
|
|
- "Manter o protocolo independente de fornecedor, modelo, IDE e agente."
|
|
- "Adaptadores reais autorizados neste recorte apenas para os CLIs Codex e Claude,\
|
|
\ Discussão e síntese com propostas para validação, conforme SVY-0001; sem ediçã\
|
|
o/execução nos repositórios."
|
|
- "Preservar CLI e arquivos portáteis, sem servidor ou API LLM obrigatória para uso\
|
|
\ básico e testes."
|
|
- "Manter as decisões de evolução do AIE neste projeto e usar Zelda 1 como piloto\
|
|
\ externo, sem alterá-lo neste Plan."
|
|
- "Tratar o importador de agendas e lessons em trabalho posterior, após estabilizar\
|
|
\ a base operacional."
|
|
acceptanceCriteria:
|
|
- "Definir a Discussão como espaço de entrada livre, organização e catálogo de ideias\
|
|
\ por tópicos, com origem, intenção humana e histórico preservados, mantendo Discussã\
|
|
o → DEC → Plan."
|
|
- "Definir como a Discussão gera sugestões e investigações, registra análises e evidê\
|
|
ncias e incorpora resultados para refinar, descartar ou reavaliar propostas."
|
|
- "Definir quando conclusões da Discussão sustentam DEC drafts, as aprovações de compromissos\
|
|
\ significativos e a derivação de planos a partir de decisões adotadas."
|
|
- "Definir a configuração por atividade de agentes, perfis e modelos, com general\
|
|
\ para síntese rastreável e execução padrão das áreas sem configuração específica."
|
|
- "Definir surveys sempre com sugestões de resposta e escolha, escrita livre, revisã\
|
|
o, pendências e retomada, organizados por tópicos em Works grandes e como tópico\
|
|
\ único em Works contidos."
|
|
- "Definir o contrato de entrada, seleção e delegação de tarefas explícitas ou em\
|
|
\ linguagem natural, contexto, retorno e persistência de resultados e evidências."
|
|
- "Definir o grau de autonomia, permissões, aprovação humana e tratamento de ambiguidades\
|
|
\ e falhas, distinguindo o padrão general das políticas de falha de executores."
|
|
- "Definir como a Discussão sugere manter um Work contido ou abrir um EPIC, com Works\
|
|
\ derivados de contexto e critérios próprios e política de acompanhamento de resultados\
|
|
\ e importância, todos importantes por padrão."
|
|
- "Definir a propagação da conclusão dos derivados, a reavaliação e a conclusão automá\
|
|
tica de EPICs pelo framework, sem LLM para o check, informando o solicitante."
|
|
- "Definir revisão de respostas e atualização de sínteses e os casos de cancelamento,\
|
|
\ reabertura, novos derivados, mudança de política e recuperação após interrupçã\
|
|
o."
|
|
- "Definir o primeiro recorte e experimentos determinísticos de refinamento dentro\
|
|
\ da Discussão, decisões e planos, continuidade entre agentes e regras de EPIC,\
|
|
\ antes de integrações reais."
|
|
- "Registrar conclusões acordadas, questões pendentes e recortes de implementação\
|
|
\ antes de iniciar a execução."
|
|
status: "COMPLETED"
|
|
createdAt: "2026-11-13T11:39:28.766559Z"
|
|
updatedAt: "2026-11-13T23:20:46.177773Z"
|
|
author: "agent"
|
|
repositories:
|
|
- repositoryId: "ai-engineering"
|
|
path: "."
|
|
head: "c84bb8d36f88ef249a249cdfe7b476fd148717af"
|
|
dirty: true
|
|
discussions:
|
|
- "DSC-0001"
|
|
- "DSC-0002"
|
|
- "DSC-0003"
|
|
- "DSC-0004"
|
|
- "DSC-0005"
|
|
- "DSC-0006"
|
|
- "DSC-0007"
|
|
- "DSC-0008"
|
|
- "DSC-0009"
|
|
- "DSC-0010"
|
|
- "DSC-0011"
|
|
- "DSC-0012"
|
|
- "DSC-0013"
|
|
- "DSC-0014"
|
|
- "DSC-0015"
|
|
- "DSC-0016"
|
|
- "DSC-0017"
|
|
- "DSC-0018"
|
|
- "DSC-0019"
|
|
- "DSC-0020"
|
|
- "DSC-0021"
|
|
- "DSC-0022"
|
|
- "DSC-0023"
|
|
- "DSC-0024"
|
|
- "DSC-0025"
|
|
- "DSC-0026"
|
|
- "DSC-0027"
|
|
- "DSC-0028"
|
|
- "DSC-0029"
|
|
- "DSC-0030"
|
|
- "DSC-0031"
|
|
- "DSC-0032"
|
|
- "DSC-0033"
|
|
- "DSC-0034"
|
|
- "DSC-0035"
|
|
- "DSC-0036"
|
|
- "DSC-0037"
|
|
- "DSC-0038"
|
|
- "DSC-0039"
|
|
- "DSC-0040"
|
|
- "DSC-0041"
|
|
- "DSC-0042"
|
|
- "DSC-0043"
|
|
- "DSC-0044"
|
|
- "DSC-0045"
|
|
- "DSC-0046"
|
|
- "DSC-0047"
|
|
- "DSC-0048"
|
|
decisions:
|
|
- "DEC-0001"
|
|
- "DEC-0002"
|
|
- "DEC-0003"
|
|
artifacts:
|
|
- "ART-0001"
|
|
- "ART-0002"
|
|
- "ART-0003"
|
|
- "ART-0004"
|
|
- "ART-0005"
|
|
- "ART-0006"
|
|
- "ART-0007"
|
|
- "ART-0008"
|
|
- "ART-0009"
|
|
- "ART-0010"
|
|
- "ART-0011"
|
|
- "ART-0012"
|
|
- "ART-0013"
|
|
- "ART-0014"
|
|
- "ART-0015"
|
|
- "ART-0016"
|
|
- "ART-0017"
|
|
- "ART-0018"
|
|
- "ART-0019"
|
|
- "ART-0020"
|
|
- "ART-0021"
|
|
- "ART-0022"
|
|
- "ART-0023"
|
|
- "ART-0024"
|
|
- "ART-0025"
|
|
- "ART-0026"
|
|
- "ART-0027"
|
|
- "ART-0028"
|
|
- "ART-0029"
|
|
- "ART-0030"
|
|
- "ART-0031"
|
|
- "ART-0032"
|
|
- "ART-0033"
|
|
- "ART-0034"
|
|
- "ART-0035"
|
|
- "ART-0036"
|
|
- "ART-0037"
|
|
plans:
|
|
- "PLN-0001"
|
|
- "PLN-0002"
|
|
- "PLN-0003"
|
|
completions:
|
|
- at: "2026-11-13T23:20:46.177773Z"
|
|
by: "human"
|
|
summary: "Conclusão aprovada explicitamente pelo usuário na DSC-0048 após revisã\
|
|
o da entrega dos PLN-0001, PLN-0002 e PLN-0003. Os 12 critérios estão vinculados\
|
|
\ às evidências verificadas e à revisão ART-0037. Discussão por tópicos/surveys,\
|
|
\ coordenação determinística de EPICs e adaptadores locais Codex/Claude para propostas\
|
|
\ foram entregues no escopo acordado. Configurado codex-cli como general deste\
|
|
\ projeto. Última execução registrada: 104 testes passando e distribuição nativa\
|
|
\ macOS ARM64; sem nova inferência neste encerramento. Capacidades fora do recorte\
|
|
\ permanecem documentadas."
|
|
humanApproved: true
|
|
scopeHash: "6a9f21dde025b54d57b3269744a0fe689c5c9a5b6d30b1fb2b012830dc338e85"
|
|
criteria:
|
|
- criterion: 1
|
|
text: "Definir a Discussão como espaço de entrada livre, organização e catálogo\
|
|
\ de ideias por tópicos, com origem, intenção humana e histórico preservados,\
|
|
\ mantendo Discussão → DEC → Plan."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0037"
|
|
- criterion: 2
|
|
text: "Definir como a Discussão gera sugestões e investigações, registra análises\
|
|
\ e evidências e incorpora resultados para refinar, descartar ou reavaliar propostas."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 3
|
|
text: "Definir quando conclusões da Discussão sustentam DEC drafts, as aprovaç\
|
|
ões de compromissos significativos e a derivação de planos a partir de decisõ\
|
|
es adotadas."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 4
|
|
text: "Definir a configuração por atividade de agentes, perfis e modelos, com\
|
|
\ general para síntese rastreável e execução padrão das áreas sem configuraç\
|
|
ão específica."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0024"
|
|
- "ART-0025"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 5
|
|
text: "Definir surveys sempre com sugestões de resposta e escolha, escrita livre,\
|
|
\ revisão, pendências e retomada, organizados por tópicos em Works grandes e\
|
|
\ como tópico único em Works contidos."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 6
|
|
text: "Definir o contrato de entrada, seleção e delegação de tarefas explícitas\
|
|
\ ou em linguagem natural, contexto, retorno e persistência de resultados e\
|
|
\ evidências."
|
|
evidence:
|
|
- "ART-0026"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 7
|
|
text: "Definir o grau de autonomia, permissões, aprovação humana e tratamento\
|
|
\ de ambiguidades e falhas, distinguindo o padrão general das políticas de falha\
|
|
\ de executores."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0017"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 8
|
|
text: "Definir como a Discussão sugere manter um Work contido ou abrir um EPIC,\
|
|
\ com Works derivados de contexto e critérios próprios e política de acompanhamento\
|
|
\ de resultados e importância, todos importantes por padrão."
|
|
evidence:
|
|
- "ART-0008"
|
|
- "ART-0017"
|
|
- "ART-0037"
|
|
- criterion: 9
|
|
text: "Definir a propagação da conclusão dos derivados, a reavaliação e a conclusã\
|
|
o automática de EPICs pelo framework, sem LLM para o check, informando o solicitante."
|
|
evidence:
|
|
- "ART-0017"
|
|
- "ART-0037"
|
|
- criterion: 10
|
|
text: "Definir revisão de respostas e atualização de sínteses e os casos de cancelamento,\
|
|
\ reabertura, novos derivados, mudança de política e recuperação após interrupç\
|
|
ão."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0017"
|
|
- "ART-0037"
|
|
- criterion: 11
|
|
text: "Definir o primeiro recorte e experimentos determinísticos de refinamento\
|
|
\ dentro da Discussão, decisões e planos, continuidade entre agentes e regras\
|
|
\ de EPIC, antes de integrações reais."
|
|
evidence:
|
|
- "ART-0005"
|
|
- "ART-0017"
|
|
- "ART-0034"
|
|
- "ART-0037"
|
|
- criterion: 12
|
|
text: "Registrar conclusões acordadas, questões pendentes e recortes de implementaç\
|
|
ão antes de iniciar a execução."
|
|
evidence:
|
|
- "ART-0001"
|
|
- "ART-0008"
|
|
- "ART-0020"
|
|
- "ART-0037"
|
|
integrations:
|
|
- path: "README.md"
|
|
sha256: "1dc449b666427e1dd029dec45a0ee7c1d6f43c026a8d062cd56130f9725c4df3"
|
|
- path: "docs/architecture.md"
|
|
sha256: "9088af9fd7fa8b3cd7bd0d3960d85fd934312c7279b6b8dd97c46f937ce3b533"
|
|
- path: "docs/protocol.md"
|
|
sha256: "8775064cc55ea64c136507ebfd34356e2f448f9bc700fa9961e12e7098899092"
|
|
- path: "docs/roadmap.md"
|
|
sha256: "8e6a460268bd841a3556c4891af72d4d4fbf724ff784e357466131df11e6a179"
|
|
- path: "docs/experiments.md"
|
|
sha256: "6ec6e63a2b3de0c92c0f451d4e4e58ba00ea6c6990f1ae863a520796c1198b7e"
|
|
- path: "docs/discussion-slice.md"
|
|
sha256: "dbf812b96262a8c36f0a4449ff66bbe5a4e03d8601e800576e9e4d4d94e000ad"
|
|
- path: "docs/epics.md"
|
|
sha256: "5fd57d356bf7ac6d58ddee4d9e73e979387a7300c7463a3f48ab0b8b7a6b0da6"
|
|
- path: "docs/cli-adapters.md"
|
|
sha256: "bbf42d7953cb3ff48e75f0ce2228d83afc87c5e10b69d02d555bcd25ca3e32e1"
|
|
noIntegrationReason: ""
|
|
origin: "HUMAN"
|
|
delegation: null
|
|
events:
|
|
- action: "STATUS"
|
|
by: "agent"
|
|
reason: "Discussão em andamento: respostas humanas registradas e consolidação em\
|
|
\ DEC drafts para revisão."
|
|
at: "2026-11-13T13:05:57.440610Z"
|
|
- action: "COMPLETE"
|
|
by: "human"
|
|
reason: "Conclusão aprovada explicitamente pelo usuário na DSC-0048 após revisã\
|
|
o da entrega dos PLN-0001, PLN-0002 e PLN-0003. Os 12 critérios estão vinculados\
|
|
\ às evidências verificadas e à revisão ART-0037. Discussão por tópicos/surveys,\
|
|
\ coordenação determinística de EPICs e adaptadores locais Codex/Claude para propostas\
|
|
\ foram entregues no escopo acordado. Configurado codex-cli como general deste\
|
|
\ projeto. Última execução registrada: 104 testes passando e distribuição nativa\
|
|
\ macOS ARM64; sem nova inferência neste encerramento. Capacidades fora do recorte\
|
|
\ permanecem documentadas."
|
|
at: "2026-11-13T23:20:46.177773Z"
|
|
archived: false
|
|
topics:
|
|
- "TOP-0001"
|
|
surveys:
|
|
- "SVY-0001"
|
|
dispositions: []
|
|
agentRuns: []
|
|
epic: false
|
|
---
|