CodeSteer Base Cognitiva Home
O segundo cérebro do projeto

A entrega passa.
O conhecimento fica.

O contexto de um projeto não pode depender de quem estava na conversa. Transforme decisões, regras e lições em uma memória que o time e os agentes conseguem consultar.

Criar minha base Entender o mecanismo

Markdown no repositório. Curadoria humana.

  • Conhecimento legível
  • Conexões explícitas
  • Revisão humana
  • Histórico versionado

01 / O mecanismo

Código conta o que existe. Alguém precisa guardar o porquê.

A Base Cognitiva organiza o conhecimento técnico que costuma se perder entre uma entrega e a próxima: o motivo de uma escolha, a regra que veio do negócio, a lição de um incidente. Cada ideia vira uma nota pequena, com origem e contexto, que sobrevive ao chat.

Explorar o repositório ↗

02 / A estrutura

Seis quadrantes. Uma pergunta de cada vez.

A pasta responde à pergunta. O tipo de documento vive no front matter. Escolha um quadrante para ver um exemplo.

Nota ilustrativa

decisions/dec-001-mensageria.md

type: adr
status: draft
source: greenfield

Adotar mensageria no fluxo de pedidos

Registrar o contexto da decisão, as alternativas consideradas e as consequências para a arquitetura.

Conexões que dão contexto

[[sys-002-eventos]]
[[spc-004-pedidos]]

Uma ideia por nota. Conhecimento conectado.

03 / O ciclo de curadoria

A base cresce junto com o trabalho.

Uma decisão de arquitetura, uma correção de padrão ou uma regra do legado. O que você aprende hoje vira contexto para a próxima entrega.

  1. 01 / Capturar

    O trabalho deixa uma lição

    Uma escolha, um incidente ou uma descoberta precisa ser registrada.

  2. 02 / Conectar

    O curador encontra o lugar

    Busca duplicatas, classifica a pergunta e conecta a nota por wikilinks.

  3. 03 / Validar

    O time revisa o conteúdo

    O rascunho vira conhecimento aprovado apenas com revisão humana.

  4. 04 / Reutilizar

    A próxima entrega consulta

    Índice atualizado e notas conectadas tornam o contexto navegável.

O índice acompanha a base. Após criar ou atualizar uma nota, cb-note chama cb-index para regenerar o índice e o README.

04 / Agent + skills

Julgamento no agente. Procedimento nas skills.

Um curador, seis procedimentos e um explorador do repositório para começar pelo código que já existe.

repo-cognitive-mapper

O projeto já tem código? O explorador faz uma leitura do repositório e propõe um plano de bootstrap com notas priorizadas em P0, P1 e P2, apoiadas em evidências do código.

05 / Memória com origem

O legado pode sair. As regras precisam ficar.

O conhecimento extraído entra nos mesmos quadrantes da base, acompanhado de sua origem e do status de migração.

O time decide o que será validado, adaptado ou descartado. A extração começa como rascunho e permanece pendente até essa revisão.

Registro de proveniência● draft

Regra de cálculo de juros

source
legacy
migration_status
pending
quadrante
decisions/

Exemplo ilustrativo de uma regra extraída. A promoção de status depende da revisão humana.

06 / Relação com o CodeSteer

Duas memórias, duas finalidades.

O CodeSteer organiza a execução das entregas. A Base Cognitiva guarda o conhecimento duradouro do projeto em seis quadrantes. São complementares: os artefatos de uma iniciativa e as notas da base têm finalidades diferentes.

.memory-bank/

Os artefatos da iniciativa

Memória do harness: o que a squad escreve para conduzir uma entrega, como specs, planos e o estado de cada iniciativa.

cognitive-base/

As notas da Base Cognitiva

O segundo cérebro do projeto: conhecimento duradouro em seis quadrantes, curado e validado por pessoas, que sobrevive a cada iniciativa.

07 / Primeiros passos

No ambiente que o time já usa.

Escolha sua plataforma, instale o pacote e peça para inicializar a base no projeto.

Instalação · Claude Code
/plugin marketplace add LuisCarlosLopes/codesteer-cognitive-base
/plugin install cognitive-base@codesteer-cognitive-base-marketplace

Instala o curador, o explorador do repositório e as seis skills no Claude Code.

Depois de instalar

Comece com uma conversa.

“Inicializa a base cognitiva neste projeto.”

Em um projeto existente, peça primeiro ao repo-cognitive-mapper para explorar o código e gerar o plano de bootstrap.

Guia completo de instalação ↗

Antes de começar

O que permanece nas suas mãos.

Preciso usar o Obsidian?

Os arquivos são Markdown e podem ser lidos no editor que você já usa. O Obsidian acrescenta Graph View, backlinks e navegação por wikilinks. Para isso, abra a pasta cognitive-base/ como vault.

Onde fica o conhecimento?

Em arquivos .md com metadados YAML, pastas e wikilinks no seu repositório. A estrutura da base usa esses arquivos e conexões explícitas, sem banco vetorial, embeddings ou indexação semântica externa.

O agente aprova as próprias notas?

Toda nota começa com status: draft. A promoção para approved requer confirmação humana. O mesmo vale para validar, adaptar ou descartar conhecimento do legado.

O próximo ciclo começa com mais contexto

Faça a próxima entrega lembrar da anterior.

Comece pela primeira decisão que o seu time não deveria precisar explicar de novo.

Começar com a Base Cognitiva Conhecer o CodeSteer