# Ariadne

> In Greek myth, Ariadne gives Theseus the thread that lets him navigate the labyrinth. > Ariadne gives AI agents a thread through a complex knowledge labyrinth.

An agent skill package for building Markdown knowledge vaults that AI agents can navigate, maintain, and operate reliably. Works with ChatGPT/Codex, Claude Code, and any agent runtime that supports the skills protocol.

The core pattern: humans choose what enters, agents compile raw material into a linked wiki, and plain Markdown remains the source of truth. Obsidian is an optional, recommended frontend; Bases and other Obsidian features are optional view layers.

```mermaid flowchart LR Human(["Human\nSources · notes · requests"]) Agent(["AI agent"])

subgraph Vault["Markdown knowledge vault"] Operating["Operating graph\nAGENTS · navigation · routing"] Checkpoints["Canonical scope checkpoints\nstable ID · path · lifecycle"] Topology["Topology synchronizer\npreview · authorize · recover"] Knowledge["Knowledge graph\nresearch · concepts · decisions"] Views["Derived optional views\nregistry · Markdown map · Canvas"] Validator["Deterministic validator\nwhole vault · scoped profiles"] end

Human --> Agent Agent -->|"enters through"| Operating Operating -->|"selects the smallest context"| Checkpoints Checkpoints --> Knowledge Topology -->|"maintains generated cores"| Checkpoints Checkpoints -.->|"generates"| Views Validator -.->|"checks"| Operating Validator -.->|"checks"| Checkpoints Validator -.->|"checks"| Knowledge Validator -.->|"checks"| Views Views -.->|"surfaces state and gaps"| Human ```

## Requirements

- A filesystem-accessible folder for the Markdown knowledge vault. - Node.js with `npm`/`npx` available for installing skills and running the bundled validator and vault-registration scripts. - A skills-capable agent runtime, such as ChatGPT/Codex, Claude Code, or another runtime that supports the skills protocol.

## Optional Obsidian F