docs: add Prometeu Engineering README

This commit is contained in:
Nilton Constantino
2026-11-16 15:22:02 +00:00
parent 96b84608ff
commit 63a5b9b145
13 changed files with 442 additions and 1 deletions
+1 -1
View File
@@ -1,3 +1,3 @@
---
schemaVersion: 2
lastWork: "0001"
lastWork: "0002"
@@ -0,0 +1,12 @@
---
schemaVersion: 1
id: "ART-0001"
workId: "WRK-0002"
origin: "Revisão local da documentação nesta sessão"
purpose: "Conferência dos links, comandos de referência, cadastro dos submódulos e\
\ integridade AIE."
path: "artifacts/evidence/ART-0001/payload"
sha256: "5a5ac6d3c67fa6154469fe6f1dc29f0bee5d0d088e9218e701d821f48c5d2985"
size: 1049
author: "codex"
createdAt: "2026-11-16T15:21:17.596766Z"
@@ -0,0 +1,37 @@
{
"file": "README.md",
"language": "pt-BR",
"verifiedLocalLinks": [
".ai-engineering/README.md",
".ai-engineering/ai-engineering.yaml",
".ai-engineering/protocol.json",
".gitignore",
".gitmodules",
"AGENTS.md",
"runtime/README.md",
"runtime/docs/specs/runtime/README.md",
"runtime/docs/vm-arch/ARCHITECTURE.md",
"runtime/rust-toolchain.toml",
"studio/README.md",
"studio/docs/specs/README.md",
"studio/docs/specs/compiler-languages/pbs/README.md",
"studio/docs/specs/compiler/README.md",
"studio/docs/specs/packer/README.md"
],
"commandsCheckedAgainst": [
"runtime/README.md",
"studio/README.md",
".ai-engineering/README.md"
],
"aieRepositories": [
"runtime",
"studio"
],
"aieValidation": {
"valid": true,
"issues": []
},
"formatChecks": "Links existentes, blocos de código fechados e nenhuma linha com whitespace final.",
"buildsAndTestsExecuted": false,
"scope": "Documentação da raiz; nenhum arquivo dos submódulos alterado."
}
@@ -0,0 +1,12 @@
---
schemaVersion: 1
id: "ART-0002"
workId: "WRK-0002"
origin: "ai-engineering:plans:2803d39a98459502e73c955be703622a8cc47dd69c7a569f4c43ee7ed6e073d7"
purpose: "Deterministic aggregation of completed Plans and reviewed cancellations;\
\ not semantic verification of prose criteria"
path: "artifacts/evidence/ART-0002/payload"
sha256: "2803d39a98459502e73c955be703622a8cc47dd69c7a569f4c43ee7ed6e073d7"
size: 283
author: "system:plans"
createdAt: "2026-11-16T15:21:18.142480Z"
@@ -0,0 +1,10 @@
{
"schemaVersion" : 1,
"workId" : "WRK-0002",
"inputHash" : "a51290e3dff5fb7c0a7d0ff332c35a98d9291d393a3dc7cc3b45c4183318e5c0",
"plans" : [ {
"id" : "PLN-0001",
"revision" : 5,
"sha256" : "507e309bdba50d03a4656516b6ce5ee54f71de57e88dba2db0e2daf96a17a87d"
} ]
}
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0001"
workId: "WRK-0002"
discussionId: "main"
kind: "NOTE"
author: "user"
createdAt: "2026-11-16T15:20:07.403258Z"
respondsTo: null
documentVersion: 2
---
Solicitação explícita nesta sessão: "escreva um README para o prometeu engineering." Escopo: documentação na raiz do workspace, mantendo somente runtime e studio como projetos versionados.
@@ -0,0 +1,18 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0002"
title: "Escrever e revisar o README do workspace"
decisions: []
steps: []
status: "OPEN"
author: "codex"
createdAt: "2026-11-16T15:20:07.665626Z"
revision: 1
previousHash: null
updatedAt: "2026-11-16T15:20:07.665626Z"
updatedBy: "codex"
changeReason: "Plan created"
documentVersion: 2
---
@@ -0,0 +1,29 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0002"
title: "Escrever e revisar o README do workspace"
decisions: []
steps:
- id: "TSK-0001"
title: "Escrever README em português e conferir referências e comandos locais"
description: ""
acceptanceCriteria:
- "Propósito, submódulos, ignore, início do trabalho com AIE e referências locais\
\ documentados; links e integridade AIE verificados."
dependsOn: []
status: "OPEN"
result: ""
evidence: []
updatedAt: "2026-11-16T15:20:08.090183Z"
status: "OPEN"
author: "codex"
createdAt: "2026-11-16T15:20:07.665626Z"
revision: 2
previousHash: "16f89cd1148f3383a1e267c63bc9b3e7618c263f883efc2bd944ab19ac5bfef9"
updatedAt: "2026-11-16T15:20:08.090212Z"
updatedBy: "codex"
changeReason: "Step added"
documentVersion: 2
---
@@ -0,0 +1,31 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0002"
title: "Escrever e revisar o README do workspace"
decisions: []
steps:
- id: "TSK-0001"
title: "Escrever README em português e conferir referências e comandos locais"
description: ""
acceptanceCriteria:
- "Propósito, submódulos, ignore, início do trabalho com AIE e referências locais\
\ documentados; links e integridade AIE verificados."
dependsOn: []
status: "ACTIVE"
result: "README escrito; conferindo links, exemplos e correspondência com a configuraç\
ão local."
evidence: []
updatedAt: "2026-11-16T15:21:08.185034Z"
status: "ACTIVE"
author: "codex"
createdAt: "2026-11-16T15:20:07.665626Z"
revision: 3
previousHash: "8bdd1fd4ecbfbb87e46bef9d9b004fd2c34b5361cebf0f08fcc3e966414d13dd"
updatedAt: "2026-11-16T15:21:08.185074Z"
updatedBy: "codex"
changeReason: "README escrito; conferindo links, exemplos e correspondência com a\
\ configuração local."
documentVersion: 2
---
@@ -0,0 +1,34 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0002"
title: "Escrever e revisar o README do workspace"
decisions: []
steps:
- id: "TSK-0001"
title: "Escrever README em português e conferir referências e comandos locais"
description: ""
acceptanceCriteria:
- "Propósito, submódulos, ignore, início do trabalho com AIE e referências locais\
\ documentados; links e integridade AIE verificados."
dependsOn: []
status: "COMPLETED"
result: "README em português criado com visão do workspace, submódulos, política\
\ de ignore, preparação, fluxo AIE, desenvolvimento e referências; links e comandos\
\ conferidos e validação AIE sem erros."
evidence:
- "ART-0001"
updatedAt: "2026-11-16T15:21:17.892124Z"
status: "ACTIVE"
author: "codex"
createdAt: "2026-11-16T15:20:07.665626Z"
revision: 4
previousHash: "15f998f0780319273c8b2772289fbf16b22c1b74795e81e3ae1141278fc901a4"
updatedAt: "2026-11-16T15:21:17.892152Z"
updatedBy: "codex"
changeReason: "README em português criado com visão do workspace, submódulos, polí\
tica de ignore, preparação, fluxo AIE, desenvolvimento e referências; links e comandos\
\ conferidos e validação AIE sem erros."
documentVersion: 2
---
@@ -0,0 +1,32 @@
---
schemaVersion: 1
id: "PLN-0001"
workId: "WRK-0002"
title: "Escrever e revisar o README do workspace"
decisions: []
steps:
- id: "TSK-0001"
title: "Escrever README em português e conferir referências e comandos locais"
description: ""
acceptanceCriteria:
- "Propósito, submódulos, ignore, início do trabalho com AIE e referências locais\
\ documentados; links e integridade AIE verificados."
dependsOn: []
status: "COMPLETED"
result: "README em português criado com visão do workspace, submódulos, política\
\ de ignore, preparação, fluxo AIE, desenvolvimento e referências; links e comandos\
\ conferidos e validação AIE sem erros."
evidence:
- "ART-0001"
updatedAt: "2026-11-16T15:21:17.892124Z"
status: "COMPLETED"
author: "codex"
createdAt: "2026-11-16T15:20:07.665626Z"
revision: 5
previousHash: "dc6be7ae04a25403541f097f49a4346829698b59c4652e760b7de7705111ae0e"
updatedAt: "2026-11-16T15:21:18.008863Z"
updatedBy: "system:plans"
changeReason: "All required steps completed; reviewed cancellations retained"
documentVersion: 2
---
@@ -0,0 +1,66 @@
---
schemaVersion: 1
id: "WRK-0002"
title: "Documentar o Prometeu Engineering no README da raiz"
description: ""
goal: "Apresentar o workspace, seus dois submódulos e o fluxo de engenharia com AIE\
\ em um README em português."
motivation: ""
constraints: []
acceptanceCriteria:
- "README.md explica propósito, runtime, studio, inicialização dos submódulos e polí\
tica de ignore."
- "README.md orienta o fluxo AIE e referencia documentação e comandos verificados\
\ nos arquivos locais."
status: "COMPLETED"
createdAt: "2026-11-16T15:19:58.000374Z"
updatedAt: "2026-11-16T15:21:18.154806Z"
author: "codex"
repositories: []
discussions:
- "DSC-0001"
decisions: []
artifacts:
- "ART-0001"
- "ART-0002"
plans:
- "PLN-0001"
completions:
- at: "2026-11-16T15:21:18.154806Z"
by: "system:plans"
summary: "All required Plans completed; requester=codex"
humanApproved: false
scopeHash: "e6d2bb5571a56ed8dbe62ee7b42da149cc11f146eaa642db7ad68f4f74fefbcd"
criteria:
- criterion: 1
text: "README.md explica propósito, runtime, studio, inicialização dos submódulos\
\ e política de ignore."
evidence:
- "ART-0002"
- criterion: 2
text: "README.md orienta o fluxo AIE e referencia documentação e comandos verificados\
\ nos arquivos locais."
evidence:
- "ART-0002"
integrations: []
noIntegrationReason: "Canonical changes and execution results are recorded in the\
\ Plan step evidence"
origin: "SYSTEM_PLANS"
delegation: null
aggregation:
receipt: "ART-0002"
inputHash: "a51290e3dff5fb7c0a7d0ff332c35a98d9291d393a3dc7cc3b45c4183318e5c0"
requester: "codex"
requestId: "0835f52b-b814-465d-9fa2-e5e6851f00e9"
events:
- action: "COMPLETE"
by: "system:plans"
reason: "All required Plans completed; requester=codex"
at: "2026-11-16T15:21:18.154806Z"
archived: false
topics: []
surveys: []
dispositions: []
agentRuns: []
epic: false
---