← ClaudeAtlas

odd-memorylisted

The .odd/ memory - its contract and one reference per kind. The contract states what every kind shares (where the memory lives, the frontmatter and the whole body, append-only reports versus living-source benchmarks, recall by frontmatter then by section, the no-secrets rule, the work branch and the lone commit, the reply that carries a synthesis and never the artifact); each reference says how to persist, recall and show its kind - observation reports, instrumentation reports, benchmarks, the maintainer-ruling ledgers (finding decisions, tree-entry classifications), custom stack files. Read when a report, a benchmark, a custom stack file or a decision is persisted, recalled, shown or inventoried, or when a finding is declined (wontfix) or such a decision reversed, or a tree entry is ruled runtime or non-runtime; never invoked on its own.
using-system/oddyssey · ★ 6 · AI & Automation · score 71
Install: claude install-skill using-system/oddyssey
# The `.odd/` memory contract The ODD loop's memory is a set of committed files in the observed repository, under `.odd/`: git versions them, pull requests review them, every user of the repository shares them — no side-channel storage, nothing opaque. It has five kinds, each with the reference that owns its specifics (its paths, its frontmatter fields, its recall matching, its branch name, its commit subject, what its reply carries, and how a stored one is shown): | Kind | Store | Reference | | --- | --- | --- | | Observation reports | `.odd/observe-run-reports/` | [references/observe-run-report.md](references/observe-run-report.md) | | Instrumentation reports | `.odd/otel-instrumentation-reports/` | [references/otel-instrumentation-report.md](references/otel-instrumentation-report.md) | | Maintainer rulings | `.odd/decisions.md` (findings) and `.odd/entry-classifications.md` (tree entries), written by `scripts/odd_ledger.py` | [references/decisions.md](references/decisions.md) | | Benchmarks | `.odd/benchmarks/<name>/` | [references/benchmark.md](references/benchmark.md) | | Custom stacks | `.odd/observability-stacks/<name>.md` | [references/observability-stack.md](references/observability-stack.md) | This file owns what they share; a reference states only its specifics. A sixth kind is a new row in this table and a new reference, never a sixth copy of these rules. ## Reading a reference by section A reference is read like a stack reference — by the section a step need