Skip to content

Commit 1776b05

Browse files
committed
docs(epiphany): code-arc knowledge loss is 30-50% of session tokens (ambient)
Third finding appended to EPIPHANIES.md — orthogonal to cold-start tax (20-30 turns) and find-code discount (10⁷×). This is the AMBIENT channel: 30-50% of every session's token budget burns on rediscovering what code paths exist / what was tried / why code is shaped the way it is. The prompt↔PR ledger collapses all three channels to two text-file reads: - Cold-start: 20-30 turns → 3-5 turns (~6×) - Find-code: ~25M tokens → ~25 tokens (10⁷×) - Ambient: 30-50% → 0% (2×-eternal) https://claude.ai/code/session_01SbYsmmbPf9YQuYbHZN52Zh
1 parent 1fccea0 commit 1776b05

1 file changed

Lines changed: 25 additions & 0 deletions

File tree

.claude/board/EPIPHANIES.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,3 +20,28 @@ ledger-first, code-never-unless-necessary.
2020
Cross-ref: PR #213 (lance-graph, 41 prompts × merged PRs), PR #110
2121
(ndarray, 25 prompts × merged PRs). Both shipped in ~90s on a dumb
2222
enumerate+match+append loop. No code reads, no MCP, no synthesis.
23+
24+
## 2026-04-19 — Code-arc knowledge loss is 30-50% of session tokens (ambient)
25+
**Status:** FINDING
26+
**Scope:** @workspace-primer domain:bookkeeping
27+
28+
Empirical (per user, 2026-04-19): **30-50% of session tokens** burn on
29+
rediscovering what code paths exist, what was tried, what got reverted,
30+
what decisions led to the current shape. This is **orthogonal** to the
31+
20-30-turn cold-start tax — it's the *ambient* loss across every query,
32+
every subagent spawn, every refactor.
33+
34+
The ledger closes three channels at once:
35+
36+
| Channel | Before | After | Discount |
37+
|---|---|---|---|
38+
| Cold-start (once per session) | 20-30 turns | 3-5 turns | ~|
39+
| Find-code (per query) | ~25M tokens (grep codebase) | ~25 tokens (grep ledger) | 10⁷× |
40+
| **Ambient arc knowledge (every turn)** | **30-50% of session budget** | **~0%** | **2×-eternal** |
41+
42+
All three channels collapse to two text-file reads: PROMPTS_VS_PRS.md +
43+
PR_ARC_INVENTORY.md. The second file is read only when arc detail is
44+
needed (Knowledge Activation trigger), so the routine cost is 0.
45+
46+
Cross-ref: PR #110 (ndarray ledger), PR #213 (lance-graph ledger).
47+
EPIPHANIES.md 10⁷× finding above.

0 commit comments

Comments
 (0)