AgenticSystemCore
SummaryAn open format and a set of rules that turn a folder of Markdown into a wiki, a graph, an agent memory, a skills library, starting architectures and a shared live board for agents and people, published here as a node of itself.
Auto-wiki, distributed agentic memory, live specifications, evolving skills, starting architectures and a self-driving live board — one open format for people and agents. Reference Node Level-0 of the Agentic Knowledge Web.
AgenticSystemCore turns one folder of Markdown into a website, a knowledge graph and a local tool server for AI assistants at once — every link typed, every published artefact carrying a digest a reader can check, every change merged by a person or by a rule that person recorded — so people, search engines and AI agents read the same checked knowledge, with no server, database or language model needed to build, check or publish it.
Reading the graph…
graph.jsonld. Hover a node for a second to read its summary. Open the explorer to search, list and inspect every node, to add the peer node it names, or to explore another node.- Try it in five minutes: install the package and run each mode from an empty folder.
- Use it on your own files: seven short guides, one per mode and one for publishing, every command with the lines it prints.
- The six ways to use it: one folder of files, six modes.
- Read the specification: the rules, the schemas and the test cases.
AgenticSystemCore is an open specification and reference implementation for knowledge that people and software agents can both read, verify and build on: a memory substrate that is deterministic, auditable, and governed by published conformance rules rather than by convention.
This site publishes the specification and is itself a node of it: its vocabulary items, its discovery document, its graph and its agent-facing text file follow the rules they describe, and the discovery validator checks the site at Level 2 before every publish.
What each reader gets
| You are | You get | Where |
|---|---|---|
| A person with notes | a wiki that checks and links itself, and a project's living memory | the Mode 0 guide: agsc init, a security contact, one commit, agsc ci, agsc build |
| A team | a live board and shared skills | the six modes, skill packs, this site's own board |
| An agent or an assistant | memory it can find, verify and cite; tools on every item page | the discovery document, llms.txt, the chunk export |
| An implementer | a specification with vectors and standalone checkers, in any language | the specification, how to read it |
| A publisher | static files, no server to run and nothing to pay for beyond hosting | publish a Level-0 node |
What is different about it
Other systems have some of these. To the author's knowledge none has them together: a knowledge base a machine can find through registered web mechanisms, a digest on every artefact its discovery document links, a typed graph with a published vocabulary, bytes pinned by conformance vectors, a person on every merge — directly, or by a standing rule that person recorded — and a starting harness out of the same files, with no server.
These are claims about the specification's text and its test vectors, not performance claims. The dated comparison with other systems is in the related work, and the full sentence in the introduction.
How it compares
What it shares with others' work, and how it differs:
- LLM wikis (Andrej Karpathy's idea, the Decoding AI workshop): the same aim — Markdown pages, sources kept apart, knowledge prepared in advance. There a model writes pages and a link's kind lives in prose; here links are typed, deterministic checks find orphans and stale links, and a model proposes but never merges.
- The Ontology Pipeline (Jessica Talisman): six stages from controlled vocabulary to knowledge graph. The graph stage works today, the others in part; version 1.1 is planned to follow them. No compatibility is claimed.
- Google's Open Knowledge Format: also Markdown with a header, but link kinds stay in prose; no discovery layer or digests.
- llms.txt: a node publishes one, with a fixed grammar, beside a discovery document giving each artefact's digest.
- Agent discovery (IETF survey) finds who can act; this finds what is known. RFC 9727 (api-catalog) is the design precedent.
- Wikibase and Wikidata: a typed graph in a served wiki with live writes; here, static files under version control.
Details in the paper; source on GitHub.
Six ways to use it
- Auto-wikiMarkdown in, a checked and linked website out; no model needed.
- Distributed agentic memoryAgents read, cite and propose; people ratify; nodes peer with each other.
- Live specificationsA project's decisions, specs, tasks and gates as one governed memory.
- Evolving skillsEach cluster becomes a skill pack of its published items; improved skills come back as Procedures.
- Runnable knowledgeSelect Concepts, get a starting Harness: seven kinds of file an architect or a runtime starts from.
- The live boardAgents and people pull, claim and finish a project's tasks on one shared board until it is done.
One folder of files, one format, six ways of using it. The six modes explain each.
What it is best for
For agents
- Memory for one agentRun
agsc mcpin a Bundle: an assistant gets seven tools to search, read, follow links and cite items by address, and nothing leaves the machine. - Shared memory for manyEvery agent reads the same published files and changes them only by proposals a person ratifies.
- A source of skillsEach cluster becomes one skill pack holding its items, procedures first, with a lockfile of their digests, installable into agent tool folders.
- A starting harnessSelected Concepts become a harness of seven kinds of file an architect or a runtime starts from; not a running system.
- A live board for a team of agentsAgents claim and finish tasks until a board is done; decisions stay with people.
- Knowledge across nodesA client reads several nodes' graph dumps and joins them on its own side, every foreign result marked with its origin.
For people
- A wiki that corrects itselfMarkdown in; a checked, linked, searchable site out, with every change reviewed.
- A project's living specificationsDecisions, specifications, tasks and gates as one governed memory.
- A library of patternsConcepts with sources and provenance, readable without JavaScript, composable into a starting architecture.
- A team boardA board exported from a project tool becomes a live board and goes back again: 11 board formats, listed below.
Works with the tools you already use
Every name below is read from the reference engine's own registries when this page is built.
- Imports and exports: Markdown, the Open Knowledge Format, JSON-LD, JSONL and chunk exports, and adapters for project boards, COGX memory archives, GABBE kits, a compact context file for a model, Mermaid link diagrams, skills repositories.
- Steering files for coding assistants: AGENTS.md, Aider, Claude Code, Cline, Codex, GitHub Copilot, Cursor, GABBE, Gemini CLI, Kiro, Windsurf.
- Skills, both ways: plugin marketplaces, Claude Code plugins, Agent Skills folders, Cursor rules, Windsurf rules.
- Project boards, both ways: this format's own board file, Asana, GitHub issues and projects, GitLab, Jira, Linear, plain Markdown, Notion, Obsidian Kanban, Todo.txt, Trello.
- For assistants: a local MCP server (
agsc mcp), and the same seven tools registered on every item page and on/compose/of a built site for a browser's own agent. - In your repository: a GitHub Action that runs
agsc ci, and a pre-commit hook that runsagsc lint. - Where a node can live: Cloudflare Pages, nginx or Apache, GitHub Pages behind a proxy, your own machine, a clone of the repository, IPFS through a gateway, a ledger-anchored record — any place that serves the files over HTTPS;
agsc-host listsays what each place can and cannot do.
A distributed brain, with no server
Each node is a folder of files published as a static site. Nodes find and read each other through registered web mechanisms, every file they point at carries its digest, and they share one vocabulary. A node names its peers; a reader walks from one to the next. No node calls another, and no server sits in between. This node's peer is a second node, patterns.agenticsystemcore.com: a demonstration node run by the same reference engine, whose sample content is a small set of well-known agent-system patterns described from public sources.
Measured, reproducible
Measured against specification 1.0.0 with the reference engine; each command reproduces its line, run in a clone of the engine repository at the release tag, with <dir> a folder outside the clone. In the token and accessibility lines, <scratch>/node_modules holds the packages those layers load from outside the clone (gpt-tokenizer; playwright-core and axe-core), <chrome> is a Chrome or Chromium executable, --nodes takes each node's name and built site, and --exports each node's llm-context export. None of these is a comparison with another system.
| What | Result | Reproduce with |
|---|---|---|
| Conformance | 243 vectors pass, 0 fail, of 250 (7 withdrawn); 327 of 332 active rules have a machine check | SOURCE_DATE_EPOCH=1767225600 node bench/measure.js --layer conformance --scratch <dir> |
| Determinism | 49 files compared across two builds, and across time zones and locales: 0 differ | SOURCE_DATE_EPOCH=1767225600 node bench/measure.js --layer determinism --scratch <dir> |
| Security floor | 108/108 seeded faults handled, 14/14 clean controls left alone. This proves neither safety nor the absence of new kinds of injection (AGSC-08-19) | SOURCE_DATE_EPOCH=1767225600 node bench/measure.js --layer security --scratch <dir> |
| Accessibility | 0 automated violations on the 100 pages this site had when it was measured, in the light and dark schemes; automated checks find only part of what matters, so this is a floor, not a claim | SOURCE_DATE_EPOCH=1767225600 NODE_PATH=<scratch>/node_modules CHROME_EXE=<chrome> node bench/measure.js --layer a11y --scratch <dir> --nodes <name>=<www>,… |
| Build scale | 5,000 items built in 34.6 s, 10,000 in 86.6 s (median of three runs, one machine); 0 pages over the 100 KB budget | SOURCE_DATE_EPOCH=1767225600 node bench/measure.js --layer perf --scratch <dir> # sizes 100 500 1000 5000 10000, 3 runs each, median |
| Tokens per chunk | median 100 tokens per chunk of this site's chunk export (cl100k_base) | SOURCE_DATE_EPOCH=1767225600 NODE_PATH=<scratch>/node_modules node bench/measure.js --layer tokens --scratch <dir> --nodes <name>=<www>,… --exports <name>=<dir>,… |
Get started
Install the command line (Node.js 22.13 or later, git), then, in a folder of Markdown notes:
npm install --global agentic-system-core # puts agsc on the PATH
agsc init # each note gets a type, a title and its provenance
mkdir -p .well-known && printf 'Contact: mailto:you@example.org\n' > .well-known/security.txt
git init -q && git add -A && git commit -q -m 'my notes' # the build takes its instant from this commit
agsc ci # lint, build twice, compare the bytes, verify
agsc build # the site, the graph and the agent files in www/
agsc mcp # give an assistant seven tools over the same folder
Without the security contact, agsc ci stops with AGSC-E901; without a commit (or SOURCE_DATE_EPOCH), with AGSC-E204. The Mode 0 guide walks through it with the lines each command prints, and the guides do the same for every mode. The demos run each mode from an empty folder; the assistant setup guide and the start page for each kind of reader go further.
This site is a node of itself
Everything published here follows the rules it publishes: the vocabulary items, the discovery document, the graph and the agent-facing text file are written by the reference engine, and the discovery validator checks this site at Level 2 before every publish. The status page says which further parts are live.
Where to start
- Everyone: start here — one path for each kind of reader.
- People: the guide, then the specification and the vocabulary.
- Architects and implementers: the architecture, the requirements, the discovery profile and the ontology.
- Agents:
/.well-known/knowledge-linksetor/llms.txt. - Publishers: publish a Level-0 node from any CMS or wiki export.
Propose an edit — opens content/index.md; a submitted change becomes a pull request a person reviews.