CEOS — Manual de uso

Como operar o Cognitive Evolution OS no dia a dia. Para as regras formais, veja o CLAUDE.md; este é o guia prático.

O ciclo básico

Capturar. Qualquer ideia, link ou trecho entra como nota Captura no vault/Inbox/ (untrusted: true). Não é confiável e não é executável — é só matéria-prima.
Processar. Você (ou o curador) promove a captura a uma classe: Topico, Problema, ModeloMental ou Claim. Isso zera o untrusted.
Aprender. Tópicos sobem a escada de evidência (0–7) — e só sobem com evidência, não com sensação de familiaridade.
Revisar. O FSRS agenda fsrs_due. Toda sessão começa por retrieval practice (recuperação ativa) do que está vencido.
Registrar. Todo ato relevante vira uma linha em vault/events.jsonl.

As classes de nota

Classe	Para quê	Campos-chave
`Topico`	Unidade de conhecimento	`nivel_evidencia` (0–7), `fsrs_due`, `fundamental`, `porque`, `related`
`Problema`	Algo que você quer mudar	`competencias_necessarias`, `projetos`, `ferramentas`, `modelos_mentais`, `pessoas`, `kill_criteria`
`ModeloMental`	Ferramenta de raciocínio	`dominio`, `porque`, `related`
`Claim`	Afirmação verificável	`fonte`, `tipo_evidencia`, `confianca` (0–1), `status`, `verificado_em`
`Captura`	Entrada bruta não confiável	`origem`, `untrusted: true`, `processado_por`

Modelos prontos em vault/Templates/. Copie o template, preencha o frontmatter, e rode a validação (abaixo).

A escada de evidência (0–7)

0 Capturado · 1 Exposto · 2 Compreendido (reconhecimento) · 3 Recuperado (recall) · 4 Explicado (Feynman + 1ª revisão) · 5 Aplicado (problema novo) · 6 Transferido (contexto diferente) · 7 Ensinado/Criado.

Regra: só evidência sobe o nível; uma revisão falha desce. WIP máximo de 3 tópicos em em_estudo ao mesmo tempo.

Falar com o agente CEOS

O agente 🧠 CEOS (workspace /opt/ceos/vault) opera sob as regras de escrita do CLAUDE.md. Pelo gateway:

openclaw agent --agent ceos -m "Comece a sessão de hoje com retrieval practice."

Ele pergunta antes de explicar (generation effect): espere ser questionado e tente gerar a resposta antes de receber a correção.

Validar o vault

python scripts/validate.py          # todo o vault + events.jsonl
python scripts/validate.py vault/Topics/uma-nota.md
python scripts/test_validate.py     # testes do validador

Sai com código != 0 em qualquer violação de schema. Rode antes de commitar.

O que é público vs. privado

O site em ceos.compositelab.net publica / (home) e /docs (este manual + design). /dashboard e /status são protegidos por basic auth. O vault em si (vault/) nunca é publicado — vive só no repositório privado e na VPS.