ORDOVA
Canon · Canonical sources

Where truth
is kept.

This document names the surfaces an agent shall consult to find the canonical material that governs how the work is done.

source: canon/canonical-sources.md

Preamble

Where the sibling pattern defines how a fact earns a single canonical source, this charter names the surfaces themselves.

It is an inventory, lifted into prose from a tool that once composed it; the manifest endures though the server does not.


I
the global directives
ratified · amendable
Article

The Rules shall govern every session.

The global agent directives shall be loaded by the System on every session.

Beneath ~/.claude sit a top-level CLAUDE.md of global rules and a set of domain-specific pointer stubs for github, xcode-build, app-store-connect, and misc, each pointing onward into the Charter. Both are symlinked from async-digital-ltd/executive; an edit lands in that checkout immediately.

No edit shall be made beneath the configuration root without per-action consent, as the discipline of identity requires.

global CLAUDE.md + rule pointer stubs under ~/.claude; symlinked from async-digital-ltd/executive
II
the behavioural store
ratified · amendable
Article

Memory shall travel with the Archive.

Behavioural rules and references shall be held in the per-project auto-memory store.

Claude Code keeps auto-memory per project beneath ~/.claude. An index, MEMORY.md, is loaded into every conversation within a project, attended by one file per topic holding individual feedback, project, reference, and user entries.

Every Claude project on the machine shall resolve to the same shared store, for each project's memory directory is a symlink to the Archive's single flat memory directory; thus memory travels with the Archive and not with the Executive.

per-project auto-memory under ~/.claude: MEMORY.md index + one file per topic → Archive's flat memory/ dir
III
state and capture
ratified · amendable
Article

The Archive shall hold the record.

State and concept capture shall live in the Archive, cloned to the working surface.

To orient within the Archive, the Hand shall read the root, which links to every per-folder index; then the reference articles and framing notes, the active long-form plans of the incubating folder, and the completed records of the released folder.

The operational folders are not canonical for method, yet they are canonical for state: for what was decided, what was captured, and what remains pending. No agent shall treat them as mere scratch.

async-digital-ltd/archive → cloned to ~/Claude/knowledge_vault_bot (a legacy path); Home.md, articles/, projects/{incubating,released}/
IV
the ordered convention
ratified · amendable
Article

Descriptions shall be drawn in order.

When any of these files is listed or summarised, its description shall be drawn from a fixed order of preference.

The description is taken first from the YAML frontmatter description field, if present; failing that, from the first H1 after any frontmatter block; failing that, from the first non-empty line of body content.

This is the convention the archived summary tool once used. Carrying it forward in prose keeps frontmatter discoverable by hand-rolled tooling without binding the work to any single server implementation.

description ← (1) frontmatter description: (2) first H1 (3) first non-empty body line
V
the proper home
ratified · amendable
Article

This inventory shall reside in the Charter.

This inventory shall dwell in the Charter and not in the Executive.

The Executive changes at the pace of a session; the Archive changes without cease. This inventory shall change only when a whole category of canonical material is added, removed, or restructured.

Such change is the work of method, and method belongs to the Charter. Here it shall remain.

lives in the charter, not the executive; amend only on category-level change

Ratification

These Articles may be amended in the open, as a charter shows its revisions.

ordova · canon/canonical-sources.md · ratified

The cursor waits for the next hand.

© Async Digital Ltd