Wiki · Gustavo + Hermes

SCHEMA

Leitura de 6 min

Wiki Schema

Domínio

Fonte única de conhecimento do Gustavo Campos e do Hermes (decisão de 22/10/2026). Cobre o que aprendemos sobre:

  • (a) Engenharia de IA/LLM: comportamento dos modelos (não-determinismo, saída estruturada, LLM como juiz) e custos/preços.
  • (b) Mercado de vagas remotas para engenheiros morando no Brasil (funil de vagas “LATAM remote”, salários, tempo de vaga aberta, vagas específicas).
  • (c) Construir com agentes: o setup real do Hermes (jobs agendados, gates, custo de rodadas).
  • (d) Incubadora/negócios: geração de ideias (EXPANDIR), viabilidade (FILTRAR), calibração.
  • (e) Plataformas e distribuição: regras, termos e preços de LinkedIn, X e afins.

O sistema de conteúdo (posts por canal) vem DEPOIS e lê deste wiki: todo fato de um post precisa ser um claim daqui. O Cérebro do Notion (3 páginas) foi ingerido em raw/notion/ e fica superado por este wiki.

Idioma: páginas em pt-BR. Trechos citados de fonte ficam na língua original, entre aspas.

Estrutura

wiki/
├── SCHEMA.md     # este arquivo (convenções + taxonomia)
├── index.md      # catálogo por tipo, 1 linha por página
├── log.md        # registro append-only
├── lint.py       # checador (python3 stdlib): rode `python3 lint.py`
├── raw/          # Camada 1, IMUTÁVEL (o agente nunca edita)
│   ├── experimentos/  # *-resultados.md dos experimentos de IA
│   ├── docs/          # documentos internos (calendário, expandir, filtro, proposta)
│   ├── notion/        # páginas do Cérebro exportadas (somente leitura)
│   ├── articles/      # páginas web (web_extract / browser)
│   └── assets/
├── claims/       # Camada 2: UMA afirmação atômica citável por arquivo
├── concepts/     # Camada 2: conceitos/temas (hubs que ligam claims)
├── entities/     # Camada 2: só entidades centrais (empresas, produtos, plataformas)
├── comparisons/  # Camada 2: comparações (vazio no v0)
├── queries/      # Camada 2: respostas arquivadas (vazio no v0)
└── tests/        # testes de aceitação (ex.: regenerar posts só com claims)

Convenções

  • Nomes de arquivo: minúsculas, hífens, sem acento, sem espaço (preco-da-inteligencia.md). O slug é o nome sem .md.
  • Toda página da camada 2 começa com frontmatter YAML (ver abaixo). Listas no formato fluxo [a, b]; numeros como lista JSON de strings.
  • Links: [[slug]] (ou [[slug|texto]]). Mínimo 2 links de saída por página. Toda página precisa de ≥1 link de entrada vindo de outra página (index e log não contam).
  • Ao alterar uma página, atualizar updated.
  • Toda página nova entra no index.md; toda ação entra no log.md.
  • Proveniência: parágrafos/itens com fatos terminam com ^[raw/caminho.md]. Obrigatório nos claims (seção Evidência) e em conceitos que juntam 2+ fontes.
  • Datas no formato AAAA-MM-DD no frontmatter; no texto pode ser DD/MM/AAAA.

Frontmatter

Páginas gerais (concept, entity, comparison, query)

---
title: Título
type: concept | entity | comparison | query
created: 2026-10-22
updated: 2026-10-22
tags: [da taxonomia]
sources: [raw/...]
---

Claim (claims/)

---
title: "Afirmação curta"
type: claim
created: 2026-10-22
updated: 2026-10-22
confianca: C0 | C1 | C2 | C3
valido_ate: 2026-11-01 | null
numeros: ["688", "94%", "16/52"]
sources: [raw/...]
tags: [da taxonomia]
---

Corpo do claim:

  1. A afirmação em 1-2 linhas (sem tom de canal).
  2. ## Evidência: de onde sai cada número, com ^[raw/...] e os números exatos da fonte.
  3. ## Ressalvas: tamanho da amostra, data, modelo, viés.
  4. ## Ligações: ≥2 [[wikilinks]].

Regras do claim:

  • Atômico: uma coisa só, mas a coisa inteira (Matuschak). Se precisa de “e” para juntar dois fatos independentes, são dois claims.
  • Todo número em numeros aparece no corpo do claim E em pelo menos uma das fontes (o lint confere por texto, normalizando separador de milhar e vírgula decimal). Número derivado (conta nossa) só entra se a conta e o resultado estiverem numa fonte; senão não vira claim.
  • valido_ate: data em que o dado envelhece (janela de vagas, preço de API, contagem de jobs). null = não envelhece (experimento datado).
  • Conflito entre claims: anotar contesta: [slug] no frontmatter e as duas posições com data.

Escala de confiança (unificada com mapa/LINGUA.md)

  • C0 chute: opinião/tese nossa, ou regra repetida sem fonte. Pode orientar decisão; em post, só como opinião explícita.
  • C1 fonte citada: vem de uma fonte externa ou documento com fonte (preço oficial, relatório, termos de uso). Também decisões registradas.
  • C2 medido por nós, amostra pequena: experimento ou contagem nossa, rodado uma vez ou com n pequeno.
  • C3 medido e repetido: medido por nós mais de uma vez (ou por nós + fonte independente) com o mesmo resultado. Tudo que sai de @llm nasce C0 até passar por verificar.

raw/

---
source_path: /caminho/original   # ou source_url: https://...
ingested: 2026-10-22
sha256: <sha256 do corpo, tudo depois do --- de fechamento>
---

Nunca editar o corpo. Correção vai na página da camada 2. Reingestão: recalcular hash; se mudou, novo arquivo datado e registrar no log.

Taxonomia de tags

Regra: toda tag usada precisa estar aqui. Tag nova entra aqui ANTES de ser usada.

  • (a) IA/LLM
    • ia-comportamento: como modelos se comportam (aleatoriedade, temperatura, repetição)
    • ia-custo: preço de tokens, custo de experimentos, tendência de preço
    • ia-avaliacao: LLM como juiz, notas, limiares
    • saida-estruturada: JSON, schema, contrato de saída
  • (b) Mercado de vagas
    • mercado-vagas: funil, volume, qualidade das vagas
    • salario: faixas e pisos
    • latam-brasil: elegibilidade de quem mora no Brasil, LATAM
  • (c) Agentes
    • agentes: construir com agentes (Hermes e afins)
    • automacao: jobs agendados, gates, o que roda sozinho
  • (d) Incubadora
    • incubadora: meta-sistema, rodadas, decisões
    • geracao-de-ideias: EXPANDIR, colapso, fontes de ideia
    • viabilidade: FILTRAR, CAC/LTV, modelo financeiro
  • (e) Plataformas
    • plataformas: regras de distribuição em geral
    • linkedin
    • x-twitter
    • termos-de-uso: ToS, API terms, políticas de automação
  • Meta
    • experimento: resultado de experimento nosso
    • verificacao: checar saída, fact-check, lint, laço de qualidade
    • conhecimento: gestão de conhecimento (wiki, Cérebro, RAG)
    • empresa: página de empresa/organização

Limiares de página

  • Claim: sempre que um fato pode ir num post ou numa decisão.
  • Conceito: tema que liga 2+ claims ou aparece em 2+ fontes.
  • Entidade: só se central (fonte de vários claims ou alvo de decisão). Menção de passagem não ganha página.
  • Página > 200 linhas: dividir.

Lint (python3 lint.py)

Erros (falham): frontmatter faltando campo, type inválido, confiança fora de C0-C3, valido_ate mal formatado, tag fora da taxonomia, wikilink quebrado, página órfã, página com < 2 links de saída, página fora do index, claim sem fonte em raw/ ou fonte inexistente, número de numeros ausente do corpo ou de todas as fontes, marcador ^[raw/...] para arquivo inexistente, drift de sha256 em raw/, claim sem seções Evidência/Ressalvas. Avisos: claim vencido (valido_ate < hoje), claim C0, página > 200 linhas.

Política de atualização

  1. Fonte mais nova geralmente vence; registrar as duas posições com data.
  2. Contradição real: contesta: no frontmatter + aviso no log.
  3. Dado com valido_ate vencido: rodar a coleta de novo, ingerir a fonte nova em raw/ (arquivo novo), atualizar o claim e o log.

Visão de gráfico