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

Ontology Atlas — Understand your codebase.

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

MIT license MCP runtime inventory Local CLI Local-first Listed on mcpservers.org

The current Ontology Atlas macOS app with the Online Store project selected: the domains it contains named around it, everything unrelated receding, and the right inspector showing the project record, its code-evidence state, and the offer to connect a code folder

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 agenteContexto 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 designUm 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

The map with the Orders domain selected: unrelated concepts recede, the concepts it contains are named, and the inspector lists contains, used by, leans on and belongs to
Mapa — selecione um conceito; tudo que não está relacionado recua.
The map picker offering Flat, Galaxy, Cone, Strata and Neural views
Cinco visualizações — Plana, Galáxia, Cone, Estratos e Neural.
The Agents screen listing the coding tools found on this computer with their readiness and a chat or connection check for each
Agentes — converse com Claude Code ou Codex dentro do aplicativo.
The MCP screen with one connect button each for Claude Code, Codex, Cursor and Antigravity
MCP — um botão por agente e, em seguida, uma prova de conexão ao vivo.
The Library with gathered sources, their format and size, and the Gather, Compile and Read stages
Biblioteca — reúna qualquer documento, compile páginas de wiki citadas.
The Library Ontology workspace with the vault tree, a capability document, its frontmatter and backlinks
Documentos — edite o Markdown que se torna o grafo.
The Architecture screen comparing reviewed roles against the imports observed in code
Arquitetura — papéis revisados em relação aos imports no código.
A relation review beside the map showing the before and after lists and the reason that will be written
Revisão de relações — veja antes e depois e, então, confirme.
The History screen with an unsaved concept change, its exact Markdown diff, and Fetch, Pull and Push
Histórico — o diff exato de Markdown antes de salvar.
The Analysis screen with measurements above tabs and the things to fix grouped by kind
Análise — o que corrigir em seguida, por medição, não por pontuação.

Como funciona

  1. 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.
  2. Conecte seu agente — um botão grava a configuração do MCP; uma reinicialização e mcp-verify provam que a conexão está ativa.
  3. Peça contexto — query_ontology com operation: "agent_brief" dá ao agente um resumo delimitado para sua tarefa.
  4. 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-firstNã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
ComandoO que responde
pnpm agents:checkIntegridade das instruções de cada harness; arquivos independentes de Codex e Claude não precisam coincidir
pnpm backlog · pnpm backlog:checkRegistros de tarefa atuais e conflitos de estado concorrente; acrescente um registro UUID por observação de worktree (guia)
pnpm bundle:plan · pnpm bundle:pruneUnificar 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:changedQuais portões esta mudança realmente precisa
pnpm conflicts:scanQuais 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:checkO 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:checkPortõ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:moveMove 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:checkUma 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=200Quais 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 knipArquivos mortos, exports e tipos em todos os escopos
pnpm lessons · pnpm lessons:checkLiçõ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:adoptCompõ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:checkSe 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 --conductSimule o que um landing faria sem gravar no GitHub e execute trens até a fila esvaziar
pnpm pr:land <n> · pnpm pr:queueEnfileire um pull request para o trem de landing (ou mescle no caminho rápido) e mostre a fila e o trem em andamento
pnpm typecheckTipos 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.

Licença

MIT