Skip to content

Commit c6164c4

Browse files
docs(research): adopt Layer-2 thread-state contract + vault research wiring — Phase 30 prep
- .planning/research/THREAD.md: hard core, H-RS-substrate (pivoting), kill criteria incl. the 2026-09-30 pivot gate, claim table, EXP-RS-11 active - .planning/research/CONVENTIONS.md: append-only convention lock (C-1..C-7 seeded from Phase 29 practice + EXP-RS-11 pre-registration) - CLAUDE.md: research-thread wiring section (thread state, experiment registry, baseline rule, /consult //commission //scribe-debrief, cartographer channel, notebook workspace) - .gitignore: .cartographer-notes.md (cartographer run 2026-07-02) Pivot to Path C approved by human 2026-07-02; see .cartographer-notes.md and the vault hypothesis-ledger. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 2bcca6c commit c6164c4

4 files changed

Lines changed: 92 additions & 0 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,4 @@ data-*/
55

66
# Gardener sweep notes (local audit trail; not tracked)
77
.gardener-notes.md
8+
.cartographer-notes.md

.planning/research/CONVENTIONS.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Conventions ledger — Dynamical LBD thread
2+
3+
*Append-only convention lock (Layer-2 pack anatomy, vault:
4+
`wiki/analyses/research-routine-packs-spec.md`). Every experiment/artifact declares which
5+
conventions it uses; changing a CRITICAL row requires re-verifying all downstream consumers.
6+
Never edit rows — append a superseding row and mark the old one.*
7+
8+
| # | convention | value | set by | criticality |
9+
|---|---|---|---|---|
10+
| C-1 | Pre-2015 cutoff | `--published-before 2014-12-31` (inclusive, lexicographic on ISO dates) | Phase 29 | CRITICAL |
11+
| C-2 | Corpus | `data-kuramoto/` — 421 papers, 35 Louvain communities (bidirectional S2 crawl from 10 Feynman-pair seeds) | Phase 29 | CRITICAL |
12+
| C-3 | Benchmark gate | shared 10-pair Feynman-reduction set; evaluable pair = maps to non-Other communities; gate `n_eval ≥ 3` AND `BENCH_P10 > 0.15` (EXP-RS-06 baseline; ≥ 0.30 = success) | Phase 29 roadmap gate | CRITICAL |
13+
| C-4 | Node vectors | c-TF-IDF, top-50 terms per node (`--tfidf-top-n 50`), from `export-louvain-graph` | Phase 29 | high |
14+
| C-5 | Export schema | `{louvain_params, corpus_fingerprint, nodes, communities, edges}`; "Other" community excluded; uniform edge weight 1.0 | Phase 28/29 | high |
15+
| C-6 | EXP-RS-11 τ sweep | cosine threshold τ ∈ {0.2, 0.3, 0.4, 0.5}; headline prediction at τ=0.3; connectivity precheck `n_cc/N ≤ 0.05` required before `compute_K_stable` | EXP-RS-11 pre-registration | CRITICAL |
16+
| C-7 | Notebook workspace | LBD notebooks + exports live in `../professional-vault/prototypes/` (`kuramoto_lbd_v0*.ipynb`, `data/`); Rust-side prototypes in `prototypes/` here | Phase 29 practice | high |

.planning/research/THREAD.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Thread state — Dynamical LBD (Gen-4)
2+
3+
*Layer-2 thread-state contract (vault: `wiki/analyses/research-routine-packs-spec.md`). Read by
4+
the vault's `/cartographer` bridge in place of the retired `.gpd/` state. Keep current: same-day
5+
update after every experiment run (vault: `wiki/meta/research-operating-manual.md`, "per
6+
numerical experiment / run"). Vault mirror of the hypothesis rows: `wiki/meta/hypothesis-ledger.md`.*
7+
8+
## Hard core
9+
10+
The knowledge graph is a *dynamical system*; bridges *emerge* from generation, not static
11+
scoring (Gen-4 LBD — vault: `wiki/concepts/dynamical-lbd.md`, the three acceptance criteria).
12+
13+
## Live hypotheses (mirror of vault hypothesis-ledger)
14+
15+
| id | statement | discriminating experiment | status |
16+
|---|---|---|---|
17+
| H-RS-substrate | Cellular **sheaves** over the Louvain community graph detect multi-causal bridges better than RAFs or Kuramoto | 4-tier benchmark incl. multi-causal joint-removal ablation on the shared 10-pair Feynman set | live (**pivoting** — substrate rebuild via EXP-RS-11) |
18+
19+
## Kill criteria
20+
21+
- **Method-level:** sheaf near-section frustration does not beat the brute-force baseline
22+
(vault: `wiki/concepts/brute-force-lbd-baseline.md`) on held-out bridges.
23+
- **Pivot gate (time-bound, set 2026-07-02, human-approved):** if the Path C TF-IDF
24+
semantic-edge substrate (EXP-RS-11) yields **<3 evaluable Feynman pairs** or
25+
**`BENCH_P10 ≤ 0.15`** on the shared 10-pair set by **2026-09-30**, kill the
26+
dynamical-substrate line and revert to the brute-force baseline.
27+
28+
## Current claims
29+
30+
| claim | status | evidence |
31+
|---|---|---|
32+
| Dynamical-LBD on the pre-2015 cond-mat *citation* graph is empirically infeasible (~41 components / 153 nodes → `K_stable` bisection diverges) | verified (Phase 29 FAIL, 2026-05-05) | `.planning/phases/29-kuramoto-corpus-build/29-VERIFICATION.md` |
33+
| Sheaf near-section frustration ranks bridges on this corpus | HOLD — untestable on VOID corpus (T2 precision@10 = 0.000) | `prototypes/SHEAF_V01_RESULTS.md` |
34+
| TF-IDF cosine edges (τ=0.3) make the same corpus connected enough for spectral/dynamical LBD (`n_cc/N ≤ 0.05`, largest CC ≥ 80%) | predicted — untested (EXP-RS-11, pre-registered) | vault: `wiki/meta/agentic-experiments-research.md` § EXP-RS-11 |
35+
36+
## Active experiment
37+
38+
**EXP-RS-11** (→ Phase 30) — TF-IDF cosine semantic-edge substrate. Full pre-registered
39+
hypothesis / predictions / setup / metrics: vault `wiki/meta/agentic-experiments-research.md`
40+
§ EXP-RS-11. Decision provenance: `.cartographer-notes.md` (pivot approved 2026-07-02, human;
41+
recorded in vault hypothesis-ledger, research-portfolio, decision-timeline).
42+
43+
## Claim history
44+
45+
`CLAIMS.jsonl` (commission-compatible) is created by the first `/commission --research` run on
46+
this thread; until then the table above is the claim record. (Exact format is an open Layer-2
47+
spec question — session feedback welcome.)
48+
49+
## Last verification
50+
51+
2026-05-05 — Phase 29 verification (FAIL verdict, honest negative; gate not reached).

CLAUDE.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,30 @@ cargo run --bin resyn -- export-louvain-graph \
168168
# 4. Run kuramoto_lbd_v03.ipynb in professional-vault/prototypes/
169169
```
170170

171+
## Research thread wiring (professional-vault)
172+
173+
Besides the product track, this repo hosts the **Dynamical LBD (Gen-4)** research thread,
174+
managed by the vault at `~/Repositories/professional-vault`. For research phases (exploratory
175+
LBD experiments, EXP-RS-*), follow the vault's research structure on top of the GSD scaffolding:
176+
177+
- **Thread state** (read by the vault's `/cartographer`): `.planning/research/THREAD.md` (hard
178+
core, live hypotheses, kill criteria, claims) + `.planning/research/CONVENTIONS.md`
179+
(append-only convention lock — honor it; append, never edit). Update THREAD.md same-day after
180+
every experiment run.
181+
- **Experiment registry**: EXP-RS-* rows in the vault's `wiki/meta/agentic-experiments-research.md`.
182+
Predictions are pre-registered there **before** running — never adjusted post-hoc.
183+
- **Baseline rule**: no dynamical method is interesting until it beats the brute-force baseline
184+
(vault: `wiki/concepts/brute-force-lbd-baseline.md`) on the shared 10-pair benchmark.
185+
- **Skills**: `/consult research "<question>"` — read-only vault lookups; `/commission --research`
186+
— independent falsification of a claim/verdict before accepting it; `/scribe-debrief` at
187+
session end (auto-files lessons to the vault).
188+
- **Cartographer channel**: `.cartographer-notes.md` (gitignored) — proposals from vault research
189+
reviews land there; go/kill/pivot decisions are the human's, recorded in the vault
190+
hypothesis-ledger.
191+
- **Notebook workspace**: Python LBD notebooks + exports live in
192+
`../professional-vault/prototypes/` (see the v03 workflow above); Rust-side prototypes in
193+
`prototypes/` here.
194+
171195
## Important Notes
172196

173197
- arXiv rate limiting: `ArxivHTMLDownloader` enforces configurable delays (default 3s) between requests using `tokio::time::sleep`. Violating this causes request blocks.

0 commit comments

Comments
 (0)