Udon Addresses, Paths, References, and (possibly) Schema
(Also another (possibly last) adhoc/bespoke Verisectorium instance, trying to implement its principles and tooling as they become available.) (This is at least the third attempt at this-- some earlier ones are in .archive)
Home. Its own repository since 2026-10-09 (~/src/address-theory, github.com/v2-io/address-theory). It grew inside the udon repo, at v2/paths/ (from 2026-08-07) and then v2/references/ (from 2026-08-10); that history came along. It is used by udon (the 0.10.1 glossary; spec-lite, which cites it as [[references/def:<slug>]]) and by ai-risk-model (addr:, pinned to udon commit 90f4fb6). Paths elsewhere that still say udon/v2/references or v2/paths mean this repository.
KEY:
The priority column distinguishes the ones critical to be familiar with immediately.
The modify column indicates which ones you will almost certainly want to modify as you go, as necessary, independent of the other work done.
| Priority | File / Directory | Modify | description |
|---|---|---|---|
| 1 | ORIENT.md -> sop/src/disc-orient.md | rare | Orientation- loaded automatically for claude. doctrina, praxes, and professio aspects. Critical reading. |
| 2 | LEXICON.md | never | Full term lexicon, generated from def/ by bin/compose-lexicon: every term group whole, in outline order, with the assembler's notes on the sources at the end — critical definitions needed to understand anything and talk about it. |
| 2 | LEXICON-overview.md | never | Generated continuous reading pass over def/ leading prose (bin/compose-defs); not a second definition source. |
| 3 | PRACTICA.ud | sess | Current main efforts -- constitutes the "handoff" most of the time, or fresh entry. Keep up-to-date. |
| 4 | ADDRESSING-THEORY.outline.md | often | Central outline for this sub-project. This is the main entrypoint for understanding the domain. |
| ~ | src/ | some | Flat directory (currently) with all of the segments that the outline references -- canonical claims. |
| ~ | def/[def-term-slug].ud | some | Flat directory (currently) with all of the segments that define the terms for the LEXICON.md |
| ~ | defs.source.ud | some | INTERIM term-settling sheet (CHEATSHEET-2 lineage, bannered) -- retires when integrated into def/ (delete-test). |
| ~ | ref/ | rare | Citable primaries: symlinks to live estate sources (copies only when the source is archived/external). See ref/README.md. |
| ~ | sop/SOP.outline.md | rare | (Eventually rare, that is). Standard Operating Procedures. Will have praxes (meta) and doctrina (domain). |
| ~ | .archive/ | some | At the time of this writing, it holds, in particular, second-theory-iteration-2026-08-08/ which we are replacing. |
| ~ | inf/ | often | Stuff that is probably critical to integrate into ADDRESSING-THEORY but hasn't yet (see praxes). |
| ~ | DECISIONS.ud | often | Decision log, with provenance and authority. Append-only (mostly)-- lower items supersede earlier. |
| ~ | CHANGELOG.md | sess | Append only very open-ended / informal format. Append to throughout your session. As archeological src, not active work. |
| ~ | sop/inf/ | rare | In particular, a place to put feedback etc. at any time about the process or SOPs themselves, including praxes. |
| ~ | bin/compose-defs | rare | Regenerates LEXICON-overview.md from def/ leading prose in outline order. |
| ~ | bin/compose-lexicon | rare | Regenerates LEXICON.md from def/ (whole groups, outline order); --check exits 1 if LEXICON.md is stale. Term-link conventions shared with compose-defs in bin/lib/def_terms.rb. |
| ~ | CLAUDE.md | rare | This file-- add to it, carefully, as appropriate. Don't be redundant with proper tracking files & SOPs please |
| ∅ | AGENTS.md -> CLAUDE.md | AGENTS right now is symliked to this file | |
| ∅ | README.md -> CLAUDE.md | Also symlinked here. This can get revisted and separated when/if necessary. For now, fewer staleness surfaces. |
NOTE: While CLAUDE.md is marked as being modified rarely-- if this table above is stale-- please fix. Thank you.
@sop/src/disc-orient.md