Ontology Atlas

English | 한국어 | 日本語 | 简体中文

AI エージェントがコードを変更するなかで、システムを把握できます。

コードが何をするのか、なぜそうするのかを示すマップを、リポジトリ内に Markdown として保持します。
あなたもコーディングエージェントも、これを読み取れます。

macOS 版をダウンロード · ブラウザーで試す · ガイド

理由

コーディングエージェントは、チームがシステムの全体像を把握し続けられる速度を上回る速さでコードを変更するようになりました。Atlas は、その全体像をコードのそばに保ちます。各部分の目的、実装しているファイル、依存関係、そしてまだ誰も把握できていないことを示します。エージェントはタスクの前にこれを読み、完了後に更新を提案します。あなたは Markdown の差分として各変更を保持、修正、または却下できます。

• エージェントはコンテキストを得て作業を始めます。 Claude Code、Codex、Cursor、Antigravity は MCP 経由で、タスクに関わる概念、コードパス、依存関係、未解決の疑問を読み取ります。
• 記録の所有者はあなたです。 概念ごとに atlas/ フォルダー内の Markdown ファイル 1 つを用意し、コードと同じように Git でバージョン管理し、レビューします。
• 何が真実かは、あなたが決めます。 エージェントの提案は、あなたが承認するまで提案のままです。
• 把握できていないことも明示します。 マップ上の線は関係性の宣言であり、実行時の影響を証明するものではありません。根拠が不足している場合は安全とせず、不明として示します。簡潔なタスク引き継ぎでは、不確実性に関する記述を完全な形で保持するか、確認に必要なドキュメントの読み取りとともに省略箇所を報告します。初期分析では Markdown 内の文字どおりの例も対象から除外し、ドキュメントの根拠が切り詰められた場合は、ハッシュに紐づく元ソースの追加確認を促します。タスクのマッチングとナビゲーションには、作成者が記述した根拠を使います。コード例、非表示コメント、引用ブロックから、機能に関する主張や作業箇所を示す情報が得られることはありません。

確認する

プロジェクト — すべてのプロジェクトと、コードの根拠がどの程度あるかを確認できます。	ライブラリ — ドキュメントを取り込み、引用付きの Wiki ページを出力します。
Git — 保存前に正確な Markdown 差分を確認できます。	インサイト — スコアではなく測定値に基づいて、次に修正すべき点を確認できます。
ハーネス — リポジトリがエージェントに伝えること、ブロックすること、監視することを確認できます。	自動化 — フォルダーを最新の状態に保つ定期チェックです。

フラットマップでは、ドメインのラベルから機能の枝が間隔を空けて外側に伸び、細い線で依存関係の方向を示します。ズームすると、利用可能な行間隔に応じてマークのサイズと詳細が変化します。実装要素は、機能の横にコンパクトなグループとして配置され、名前と所属を示す線が読みやすく表示されます。概要では交差する線を抑え、エンドポイントを調べると、記録された接続と明示的にラベル付けされたバンドル数が表示されます。緩やかな局所曲線と画面サイズに合わせた矢印によって、方向を読み取りやすく保ちます。個々の関係の説明と、それを宣言しているドキュメントは、関係のレビューで引き続き確認できます。選択項目は明るい輪郭線で常に区別され、琥珀色の感嘆符は根拠の再確認が必要であることを示します。マップのキーでは、両方のマークと方向について説明します。大きなマップでも同じ枝の構成を保ちつつ、プレビューを短くし、列のグループを安定させます。「さらに表示／折りたたむ」コントロールで実際の機能を表示できます。フォーカスした領域でも同じ構成が保たれ、ラベル付きの操作でマップ全体に戻れます。「概念」パネルでは、検索、選択、ツリーの展開がそれぞれ分かれています。幅が 1280 px 未満になると、パネルはインスペクターの横に一時的に折りたたまれ、インスペクターを閉じると元に戻ります。明示的に再度開くこともできます。プロジェクトの詳細では、日付付きのソース確認履歴を 確認記録 に表示します。

空のフォルダーや関係のない概念は、別の画面からマップに戻ると、開始アクションを表示します。スターターの作成が書き込みエラーになった場合も、再試行アクションは表示されたままになります。部分的に作成された場合も同様です。再試行では既存ファイルを保持し、不足しているスターターファイルを書き込みます。完了すると、成功通知が 1 件表示されます。ポップアップツアーは廃止されました。フォルダーを開くための案内、コンテキストヘルプ、キーボードヘルプは引き続き利用できます。概念の全体表示から戻ると、その概念がマップ上で選択された状態を保ちます。メインナビゲーションから戻ると、同じフォルダーを開いている間は、このセッション中のメモリーに保持された選択中のマップ概念と「概念」の検索状態が復元されます。送信前の通常のチャットテキストは、同じフォルダーを開いている間、画面を切り替えてもメモリーに保持されます。復元されたテキストからリクエストが送信されることはありません。

ライブラリサービスのセットアップはアプリ内でのみ行います。Atlas は有効化の前に、フォルダーとキーチェーンへの保存を確認します。ブラウザーでは、サービスのトークンを収集せずに、アプリを開くか「ファイルを追加」するよう案内します。ローカルのセットアップでは、サービスへのアクセスは検証されません。ライブラリの確認履歴では、実行済みの確認が先に一覧表示されます。記録されたスリープ時間の間隔は、明示的な表示コントロールから確認できます。

クイックスタート

1. インストール：ダウンロードページからアプリをインストールするか、ブラウザー版を開きます。
2. フォルダーを開きます。 Atlas は Markdown をそのまま読み込むか、リポジトリ内に atlas/ フォルダーを作成します。書き込みを行う前にパスを表示します。
3. エージェントを接続します。 Agents › MCP で使用するツールの Connect を押し、エージェントを再起動して、次のタスクについて尋ねます。

macOS（Apple Silicon）版は署名および公証済みで、MCP サーバーがアプリに内蔵されています。Windows x64 版は未署名のベータ版です。Linux ではブラウザー版を使用するか、ソースチェックアウトから CLI と MCP サーバーを実行してください。リリースには、各バージョンのファイルとチェックサムが記載されています。

仕組み

your-repo/
├── src/
└── atlas/                 ← 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

フロントマターに kind: を含む Markdown ファイルは、1 つの概念を表します。uid は変わらず、slug は現在のアドレスで、path は説明対象のコードを示します。マップ、ドキュメント、Library、Insights、Git の各画面は、これらのファイルを読み込みます。

エージェントは 2 つの方法でフォルダーにアクセスします。

• **MCP：**エージェントが Atlas MCP サーバーを起動し、アプリを閉じていてもディスク上のフォルダーを読み書きします。エージェントを接続 · MCP リファレンス
• **ACP：**Claude Agent と Codex はアプリ内のチャットでも実行できます。書き込みはそれぞれ、許可するまで保留されます。エージェント

プロジェクトのソースパスを修復すると、該当する概念と、記録された相対パスが開きます。古い、または存在しない対象には再計測が必要です。

プロジェクトチェックでは、最後に意味をレビューしてから変更されたドキュメントと、形式が不正な入力を区別します。レビューと明示的な再確定を求めますが、対応するコードパスや保存済みの変更を意味の承認とはみなしません。分析では、変更済み、欠落、または未確認のソースエビデンスに基づいて機能を絞り込みつつ、選択した主張を開いたままにします。

分析では、責務間で記録された依存関係を比較し、選択した主張の横に、該当する概念と宣言元のドキュメントを正確に開きます。実装記録、未確認のソース、説明の欠落は、それぞれ別のものとして扱います。macOS アプリでは、ドキュメントと引用されたファイルの日付を、それぞれが属する Git リポジトリで確認できます。アクセスや履歴が存在しない場合は不明のままとなり、読み取り用に選択するフォルダーは既存の接続先と一致している必要があります。分析

ローカルファースト

インストール済みアプリの Changes プロトタイプでは、オントロジーなしで選択した Git リポジトリを読み取れます。最初のステップとして、公開 GitHub PR の読み取りを推奨します。コミットのみの説明は、明示的に制限された代替手段です。PR の更新に失敗した場合は、以前に読み取ったバージョンと説明を保持し、鮮度に関する警告を表示します。明示的に読み取った公開 PR の原文は、ローカルに上限付きで保存され、再起動後に再度開けます。保存時の読み取り日時と、現在の GitHub の状態は確認していないことが表示されます。保存したコピーは、ソースフォルダーがなくても Changes で消去できます。GitHub の既知のレート制限がある場合は再試行時刻を表示し、PR の読み取りを一時停止しますが、ローカルソースは引き続き利用できます。日単位、週単位、月単位、年単位、またはカスタムのローカル日付を選択できます。Atlas 内で、コミットメッセージ全文、変更されたファイル、上限付きのコード比較を確認できます。明示された順序で、収集済みの完全な記録のうち条件に合うものをすべて読み取ります。完了した部分はセッションの停止／続行後も保持され、選択した原文の抜粋から短い概要を作成します。ソース、処理、概要に関する不足は明示されます。現在のブランチの first-parent 履歴を読み取ります。作成者の説明や任意のオントロジーによるグループ化は、検証済みの動作変更を立証するものではありません。変更の概要

• バックエンド、アカウント、テレメトリーはありません。フォルダーはディスク上にプレーンな Markdown のまま保存されます。
• API キーを使ったモデル呼び出し、またはローカルモデルの使用はオプトインであり、呼び出し先はそれぞれ .ontology-atlas/llm-audit.jsonl に記録されます。
• 接続されたコーディングエージェントは、プロンプトと読み取った内容を独自のプロバイダーに送信する場合があります。Atlas のログはこうした転送を対象としていません。

信頼性 · セキュリティ

ステータス

Atlas はまだ初期段階です。ベンチマークでは、Atlas によって回答が改善することはまだ示されておらず、 Atlas はより遅い結果でした（訂正）。 構築に関する試行、その失敗と限界については、 構築に関する測定結果をご覧ください。

ドキュメント

Atlas とは？ · 最初の 5 分間 · 何がノードになるのか？ · 関係 · 仕様 · 機能 · CLI · アーキテクチャ

コントリビューション

CONTRIBUTING.mdをお読みください。外部からのプルリクエストはフォークから送信します。 AGENTS.mdは、人とエージェントの双方が遵守する規約です。

pnpm install
pnpm dev
pnpm checks:changed -- --run

pnpm pr:land <number> はレビュー済みのプルリクエストをマージし、元の コミットを保持します。開発時のチェックに、ゲートの全リファレンスがあります。

プッシュ前のチェックでは、プッシュ対象のコミットを確認し、関連する簡易チェックと並行して、影響を受ける lint、ユニットテスト、Node テストを実行します。ブラウザー、完全なコントラクト、依存関係グラフの検証は CI が担当します。CI ツールのテストのみを変更した場合は、無関係なプロダクトのテストスイートを開始せずに回帰テストを実行します。プランナーの実装を変更した場合は、引き続き CI での網羅的な検証が必要です。

リポジトリのコマンド

| コマンド | 確認できること | |---|---| | `node scripts/ci/run-playwright-ci.mjs --help` | テストの検出や実行を行わずに、ブラウザーのシャードオプションを確認できます。不明なオプションは実行前にエラーになります | | `pnpm agents:check` | 各ハーネスの指示ファイルが有効であることを確認できます。Codex と Claude のファイルは一致している必要はありません | | `pnpm brief:new -- --slug= --owns=` | ポート、作業用領域、チェック、マージの各項目が記入された委任ブリーフを作成できます | | `pnpm build:static` | `out/` の静的エクスポートを確認できます。前回のビルド以降にビルド入力が変更された場合にのみ再ビルドされます | | `pnpm bundle:plan` · `pnpm bundle:prune` | 複数のブランチをまとめてマージする計画を立て、その後、main に含まれるブランチを整理できます（`/merge`） | | `pnpm checks:changed` | この変更で必要なゲートを確認できます | | `pnpm conflicts:scan` | このブランチと同じファイルを変更しているオープンプルリクエストと、試験マージで競合するかどうかを確認できます | | `pnpm decisions:find ` · `pnpm decisions:check` | 引用または覆すべき決定と、この変更に決定記録が必要かどうかを確認できます | | `pnpm design:tokens -- [--prefix=]` | app/styles から解決された現在のトークンランプを確認できます | | `pnpm doc:new -- --type= --area= --slug=` | `docs/.templates/` のテンプレートから新しい継続的なドキュメントを作成できます | | `pnpm docs:check` | `pnpm docs:language`、`pnpm source:language`、`pnpm changelog:check`、`pnpm dev-checks:check`、`pnpm docs:meta` を含むドキュメントのゲートを確認できます | | `pnpm docs:meta` · `pnpm doc:history -- ` | すべての継続的なドキュメントの種類、ステータス、分野と、移動をまたいだ1つのドキュメントのコミット履歴を確認できます | | `pnpm docs:move` | `docs/.moved.json` に記載されたドキュメントを移動し、参照を書き換えます（`-- --check` は報告のみ行います） | | `pnpm e2e:durations -- ` | ダウンロードした `playwright-timings-*` レポートからブラウザーのシャードを再配分できます | | `pnpm e2e:sleeps:check` | `// measurement window:` の注記がない新しい固定 `waitForTimeout` を拒否します | | `pnpm gates:yield -- --runs=200` | CI がアップロードしたレーンレポートから、実行ごとに失敗したことのある CI チェックを確認できます | | `pnpm gateway:capture -- --base-url=` | ダウンロードページの6つのアプリ画面を、韓国語と英語で再撮影できます | | `pnpm harness:tokens -- --since=` | ローカルトランスクリプトから、エージェントの種類ごとの Claude Code トークンの使用先と、圧縮ウィンドウまたはターン上限を超えた実行を確認できます（[予算](docs/engineering/agent-effort.md#token-budget)） | | `pnpm knip` | 使用されていないファイル、エクスポート、型を確認できます | | `pnpm licenses:check` · `pnpm notice:build` · `pnpm notice:check` | 配布されるパッケージがライセンス許可リストに含まれていることと、`NOTICE.md` が最新であることを確認できます（[ルール](docs/engineering/third-party-code.md)） | | `pnpm messages:build` · `pnpm messages:check` · `pnpm messages:adopt` | 名前空間ごとのファイルから `messages/.json` を作成し、最新であることを検証して、古いブランチの編集を引き継げます | | `pnpm messages:coverage -- --locale ` | 1つのロケールの文字列を `en` と照合し、引数、複数形、スクリプト、保持用語、タイポグラフィを確認できます | | `pnpm perf:mcp:memory` · `pnpm perf:mcp:memory:check` | MCP サーバーが呼び出しを繰り返したときにメモリを解放するかどうかを確認できます。所要時間は約1分です | | `pnpm pr:ci ` | 今すぐドラフトに対して CI を実行できます | | `pnpm pr:land --plan ` · `pnpm pr:land --conduct` | マージをドライランするか、キューが空になるまでキュー内のプルリクエストをマージできます | | `pnpm pr:land ` · `pnpm pr:queue` | マージするプルリクエストをキューに追加し（グリーンのものは1回の CI 実行でまとめてマージされます）、キューを表示できます | | `pnpm review:facts -- --base=` | レビュアーが手作業で数える代わりに、行数の増加、800行のファイル、エクスポートと依存関係の変更、未変更の兄弟テスト、セキュリティ関連のパスなどの機械的な事実を確認できます | | `pnpm seo:check` | `pnpm build` の実行後、`out/` 内のすべてのサイトマップ URL がそれ自体に正規化されること、`/` と各ロケールのルートが `/{locale}/download/` を指すこと、タイトルと説明がロケールごとに一意であることを確認できます | | `pnpm typecheck` | Next の生成済みルート型とページ型を含め、すべてのファイルの型を確認できます | | `pnpm ui:audit -- --url= --route=` | 幅ごとに、レンダリング結果の事実を確認できます。水平オーバーフロー、覆われている／到達不能なコントロール、小さなタッチターゲット、オフランプの種類・角丸・影の値、低コントラスト、繰り返しセットの不一致、スクロール末尾の余白などです | `--scope=`を使用すると、表示されているモーダルまたは領域を1つ監査できます。セレクターは表示されている要素に1つだけ一致する必要があります。レポートには測定された要素数が含まれます。

ライセンス

MIT。サードパーティの通知はNOTICE.mdに、ライセンス全文はpublic/third-party-licenses.txtに記載されています。ピクセルマスコットとそのソースについては、ブランドをご覧ください。