Skip to content

Commit ffcad91

Browse files
committed
docs(reorg): rename arxiv/ -> arxiv-context-assembly/ + move paper-md into docs/papers/
- docs/arxiv/ -> docs/arxiv-context-assembly/ (parallels arxiv-thermodynamic naming) - 3 paper-content md files moved from docs/ root into docs/papers/: science.md, research-post-context-assembly.md, linkedin-endorser-post.md - Engineering docs (architecture.md, api-reference.md, benchmarks-detail.md, data-flow.md, testing-guide.md) stay in docs/ root. - Path refs updated: README.md (3), CONTRIBUTING.md (1), tasks/paper-numbers-audit.md, tasks/beam-10m-llm-head-to-head-protocol.md, docs/papers/linkedin-endorser-post.md. Build artifacts preserved through the rename. PDF still builds with `cd docs/arxiv-context-assembly && make`.
1 parent 34aa452 commit ffcad91

15 files changed

Lines changed: 14 additions & 14 deletions

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ A new mechanism PR must include:
6262

6363
1. **Primary citation.** What published neuroscience or cognitive-science
6464
work motivates this mechanism? Include the paper's bibliographic
65-
reference in `docs/science.md`.
65+
reference in `docs/papers/science.md`.
6666
2. **The mathematical form.** Equations or pseudocode showing the exact
6767
computation. If you're adapting an algorithm from the literature,
6868
call out the divergence and justify it.

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ All scores on fresh database (DROP + CREATE per run), TRUNCATE between conversat
222222

223223
Cortex doesn't store memories the way a database stores rows. It treats them more like a brain treats experiences.
224224

225-
**Memories have temperature.** Every memory starts hot. Access it and it stays hot. Ignore it and it cools. Below a threshold, it compresses: full text → summary → keywords → fades entirely. This isn't a bug — it's [rate-distortion optimal forgetting](docs/science.md), the same mathematical framework your brain uses to decide what's worth keeping. Important memories resist compression. Surprising ones get a heat boost. Boring, redundant ones quietly disappear. *(Anderson & Lebiere 1998; Ebbinghaus 1885)*
225+
**Memories have temperature.** Every memory starts hot. Access it and it stays hot. Ignore it and it cools. Below a threshold, it compresses: full text → summary → keywords → fades entirely. This isn't a bug — it's [rate-distortion optimal forgetting](docs/papers/science.md), the same mathematical framework your brain uses to decide what's worth keeping. Important memories resist compression. Surprising ones get a heat boost. Boring, redundant ones quietly disappear. *(Anderson & Lebiere 1998; Ebbinghaus 1885)*
226226

227227
**Storage has a gatekeeper.** Not everything deserves to be remembered. Cortex maintains a predictive model of what it already knows, and only stores information that violates its expectations. Tell it the same thing twice and the write gate blocks the second attempt. This is predictive coding — the same mechanism your neocortex uses to filter sensory input. Only prediction errors get through. *(Friston 2005; Bastos et al. 2012)*
228228

@@ -234,7 +234,7 @@ Cortex doesn't store memories the way a database stores rows. It treats them mor
234234

235235
**Similar memories stay distinct.** Pattern separation — modeled on the dentate gyrus, which keeps "Tuesday's standup" separate from "Wednesday's standup" even though they're almost identical. Without this, retrieval returns the same generic match for every similar query. *(Leutgeb et al. 2007; Yassa & Stark 2011)*
236236

237-
**41 papers total.** Every algorithm, constant, and threshold traces to a published source. Full citations, equations, ablation data, and per-module implementation audit: **[docs/science.md](docs/science.md)** | **[Research post on structured context assembly](docs/research-post-context-assembly.md)**
237+
**41 papers total.** Every algorithm, constant, and threshold traces to a published source. Full citations, equations, ablation data, and per-module implementation audit: **[docs/papers/science.md](docs/papers/science.md)** | **[Research post on structured context assembly](docs/research-post-context-assembly.md)**
238238

239239
---
240240

File renamed without changes.

0 commit comments

Comments
 (0)