Ontology Atlas
Uma pasta de Markdown contendo uma ontologia de codebase revisada e uma wiki citada. 38 ferramentas tipadas, somente local, cada escrita é um diff de Git.
Documentação
Ontology Atlas
Entenda seu sistema enquanto agentes de IA alteram seu código.
Dê contexto de tarefa aos agentes. Inspecione o significado, as evidências e as incógnitas você mesmo.
Baixar para macOS · Windows x64 beta sem assinatura · Demonstração ao vivo · Guia · Status

Cada captura de tela lê samples/storefront, uma loja online descrita por arquivos Markdown neste repositório.
Em 30 segundos
| O quê | Uma pasta atlas/ de Markdown dentro do seu repositório. O frontmatter de cada arquivo diz o que ele é (project, domain, capability, element, document) e para onde aponta. Essa pasta é o banco de dados inteiro. |
| Para seu agente | Contexto de tarefa tipado via MCP: capacidades, âncoras de código, dependências declaradas, evidências e incógnitas. |
| Para você | Os mesmos registros em um mapa, em documentos e como diffs de Git, para que você decida quais mudanças de significado manter. |
| Honesto por design | Um caminho no grafo é uma relação declarada, não uma prova de impacto em tempo de execução. Evidência ausente aparece como desconhecida, nunca como segura. |
your-repo/
├── src/
└── atlas/ ← the whole ontology, cloned, branched and reviewed with the code
├── project.md
├── domains/ capabilities/ elements/
├── sources/ documents kept exactly as they arrived
└── wiki/ pages written from those sources, every fact cited
Veja
![]() Mapa — selecione um conceito; tudo que não está relacionado recua. | ![]() Cinco visualizações — Plana, Galáxia, Cone, Estratos e Neural. |
![]() Agentes — converse com Claude Code ou Codex dentro do aplicativo. | ![]() MCP — um botão por agente e, em seguida, uma prova de conexão ao vivo. |
![]() Biblioteca — reúna qualquer documento, compile páginas de wiki citadas. | ![]() Documentos — edite o Markdown que se torna o grafo. |
![]() Arquitetura — papéis revisados em relação aos imports no código. | ![]() Revisão de relações — veja antes e depois e, então, confirme. |
![]() Histórico — o diff exato de Markdown antes de salvar. | ![]() Análise — o que corrigir em seguida, por medição, não por pontuação. |
Como funciona
- Abra uma pasta — o aplicativo lê o Markdown no local, ou inicia
atlas/a partir do seu código. O caminho é mostrado antes de qualquer coisa ser gravada. - Conecte seu agente — um botão grava a configuração do MCP; uma reinicialização e
mcp-verifyprovam que a conexão está ativa. - Peça contexto —
query_ontologycomoperation: "agent_brief"dá ao agente um resumo delimitado para sua tarefa. - Revise o significado — as mudanças propostas chegam como diffs de Markdown; você mantém, corrige ou rejeita no Git.
As pré-visualizações de definição preservam o texto introdutório completo; o documento completo retém exclusões e incertezas. Inspeções de código locais mostram a pasta conectada e oferecem recuperação nativa de permissões antes da leitura.
$ node $ATLAS blast-radius capabilities/mcp-tool-server docs/ontology --depth 2
capabilities/mcp-tool-server — blast radius (depth 2, incoming)
risk unknown · 1 node · 1 relation · 0 cross-domain
Como é um nó
---
uid: 71890f3e-7b5d-4c0a-8f14-123456789abc # permanent identity, kept through renames
slug: capabilities/token-issue
kind: capability
title: Token issue
domain: domains/auth
path: src/auth/token-service.ts # a path — code evidence
elements:
- elements/jwt-signer # a slug — an implementation-role node
dependencies:
- capabilities/session-refresh # a slug — another node
---
Issues access and refresh tokens for authenticated users.
Um caminho aponta para código; um slug aponta para um nó. dependencies são direcionadas e
relates é simétrica, então o mapa nunca transforma similaridade em causalidade. Somente
arquivos com kind: entram no grafo; páginas sources/** e wiki/** não entram.
Contratos completos: o que vira um nó? ·
relações ·
especificação do vault.
Princípios
| Local-first | Não é um… |
|---|---|
| Seu disco é o banco de dados; Git é o histórico. | editor de ontologia de propósito geral |
| Sem backend Atlas, conta ou telemetria. | índice de código ou IDE |
Transferências de modelo e provedor são opcionais e registradas em .ontology-atlas/llm-audit.jsonl. | aceitação automática de conhecimento gerado |
| MCP e CLI leem a pasta diretamente, mesmo com o aplicativo fechado. | implementação RDF/OWL/SHACL (§5.2) |
Extensões são arquivos que um git diff mostra a você, nunca código de terceiros. | serviço, e não está no npm |
Medido, honestamente: nosso primeiro benchmark testou principalmente vocabulário que só a Atlas conhecia. Reavaliado, ainda não medimos diferença na qualidade das respostas, e a Atlas foi mais lenta. A correção · registro do benchmark.
Status — leia antes de instalar
- A página de download é a autoridade de lançamento: tag, tamanhos, checksums e estado de assinatura. GitHub Releases é a segunda fonte.
- macOS é assinado com Developer ID e notarizado, com o servidor MCP dentro do pacote.
- Windows x64 é um beta sem assinatura — o SmartScreen pode avisar, e um PC gerenciado pode recusar. Veja Segurança.
- Linux e outros executam o aplicativo de navegador, ou a CLI e o servidor MCP a partir de um checkout da fonte.
- Cada lançamento é uma versão simples; o atualizador no aplicativo verifica a assinatura de cada arquivo antes de instalar.
Documentação
Use: guia hospedado ·
recursos · configuração do MCP ·
referência da CLI
Modele um vault: o que vira um nó? ·
relações ·
especificação ·
mapa de autoridade de qualidade
Entenda: direção do produto ·
arquitetura · segurança ·
decisões
Contribuindo
Issues e pull requests são bem-vindos; o relatório mais útil aponta a Atlas para um
repositório real e mostra onde ela fica aquém. Leia
CONTRIBUTING.md primeiro (pull requests externos vêm de
forks), e AGENTS.md é canônico para pessoas e agentes.
Comece com pnpm checks:changed -- --run; finalize com pnpm pr:land <number>.
Comandos do repositório
| Comando | O que responde |
|---|---|
pnpm agents:check | Integridade das instruções de cada harness; arquivos independentes de Codex e Claude não precisam coincidir |
pnpm backlog · pnpm backlog:check | Registros de tarefa atuais e conflitos de estado concorrente; acrescente um registro UUID por observação de worktree (guia) |
pnpm bundle:plan · pnpm bundle:prune | Unificar vários branches como um só: planeje o merge (quais carregam trabalho, arquivos compartilhados, conflitos de teste) e depois remova os branches componentes que main comprovadamente contém. Veja /land-bundle |
pnpm checks:changed | Quais portões esta mudança realmente precisa |
pnpm conflicts:scan | Quais pull requests abertos (e -- --match=<glob> branches locais) alteram os mesmos arquivos que este branch, e se um merge de teste com cada um conflita; somente leitura, uma chamada de gh |
pnpm decisions:find <terms> · pnpm decisions:check | O registro de decisão a citar ou reverter, e se esta mudança deve um |
pnpm doc:new -- --type=<kind> --area=<area> --slug=<slug> | Um novo documento vivo a partir de seu modelo em docs/.templates/, no caminho que seu tipo decide |
pnpm docs:check | Portões de docs, incluindo pnpm docs:language, pnpm source:language, pnpm changelog:check, pnpm dev-checks:check, pnpm docs:meta |
pnpm docs:meta · pnpm doc:history -- <path> | Se todo documento vivo carrega seu tipo, status e área com ponteiros que resolvem; os commits de um documento entre movimentações, que é sua versão |
pnpm docs:move | Move os documentos listados em docs/.moved.json e reescreve toda referência; execute novamente após mesclar main em um branch mais antigo (-- --check apenas relata) |
pnpm e2e:durations -- <timings dir> | Reescreve os pesos por arquivo que equilibram os shards do navegador a partir de relatórios playwright-timings-* baixados |
pnpm e2e:sleeps:check | Uma mudança não pode adicionar um waitForTimeout fixo a uma spec e2e a menos que uma nota // measurement window: diga por quê |
pnpm gates:yield -- --runs=200 | Quais verificações de CI já falharam, por execução distinta, a partir dos relatórios de lane que checks.yml envia (armazenados em cache em ~/.cache/atlas-gate-yield); uma linha com 50+ execuções, nenhuma falha e 60+ dias de histórico lê no CI failure, uma verificação para examinar em vez de excluir, pois as capturas de pre-push e pnpm checks:changed não estão nesses dados. Os relatórios começam com a mudança que os adicionou |
pnpm gateway:capture -- --base-url=<static export> | Recaptura as seis telas do aplicativo que a página de download mostra, em coreano e inglês (public/gateway/<screen>.<locale>.png), a partir de um pnpm build servido, contra a ontologia deste próprio repositório |
pnpm knip | Arquivos mortos, exports e tipos em todos os escopos |
pnpm lessons · pnpm lessons:check | Lições compartilhadas de harness que estão abertas ou verificadas, mas ainda não corrigidas; registre e revise com /harness-retro (guia de registros) |
pnpm messages:build · pnpm messages:check · pnpm messages:adopt | Compõem o messages/<locale>.json ignorado a partir de um arquivo por namespace (messages/<locale>/<Namespace>.json), provam que está atualizado e carregam as edições de catálogo de um branch pré-divisão para as partes ao mesclar main |
pnpm perf:mcp:memory · pnpm perf:mcp:memory:check | Se o servidor MCP mantém memória que deveria liberar: heap após duas coletas forçadas em 50 chamadas repetidas por ferramenta e em HEADs de Git movidos, em um vault gerado; cerca de um minuto, mantido fora do pre-push |
pnpm pr:ci <n> | Dispare CI em um draft agora, para que uma mudança verde e disjunta possa seguir o caminho rápido |
pnpm pr:land --plan <n...> · pnpm pr:land --conduct | Simule o que um landing faria sem gravar no GitHub e execute trens até a fila esvaziar |
pnpm pr:land <n> · pnpm pr:queue | Enfileire um pull request para o trem de landing (ou mescle no caminho rápido) e mostre a fila e o trem em andamento |
pnpm typecheck | Tipos em todos os arquivos, com os tipos de rota e página gerados pelo Next, para que o build do navegador não precise verificá-los novamente |
As linhas permanecem ordenadas por comando, e as entradas da referência por área, para que dois
branches que cada um adiciona um item caiam em linhas diferentes; pnpm dev-checks:check
nomeia a linha a mover e -- --fix ordena ambas.
Verificações de desenvolvimento é a referência completa de portões, uma
entrada por área; testabilidade do mapa é responsável pelo desempenho
do canvas, legibilidade, contraste e instrumentação.









