Skip to content

Commit 1fccea0

Browse files
committed
docs(epiphany): prompt↔PR ledger is 10⁷× cheaper than code grep
Create .claude/board/EPIPHANIES.md with the finding. PR #110 + lance-graph PR #213 demonstrated the dumb-bookkeeper pattern: ~90 seconds, Haiku, enumerate+match+append. Result is a grep-addressable index of every shipped artifact keyed by the prompt-file brief that birthed it. For every future "what did we ship about X" query the ledger replaces a full-codebase grep with a single line — ~25 tokens vs ~25M tokens. Seven orders of magnitude cheaper. https://claude.ai/code/session_01SbYsmmbPf9YQuYbHZN52Zh
1 parent 3c77050 commit 1fccea0

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

.claude/board/EPIPHANIES.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# ndarray — Epiphanies (append-only)
2+
3+
## 2026-04-19 — Prompt↔PR ledger is 10⁷× cheaper than code grep
4+
**Status:** FINDING
5+
**Scope:** @workspace-primer domain:bookkeeping
6+
7+
To answer "what did we ship for topic X":
8+
9+
- **Grep across code:** ~100 MB of Rust across N crates, ~25M tokens of context, minutes of agent turns.
10+
- **Grep the ledger:** one `grep X .claude/board/PROMPTS_VS_PRS.md` returns `<prompt file> | #N <title>`. ~25 tokens, sub-second.
11+
12+
Seven orders of magnitude cheaper. The pairing **prompt-file ↔ PR** is the
13+
minimum addressable record of "this artifact was built to answer this
14+
brief" — the hyperlink that replaces re-discovery by full-text scan.
15+
16+
The line is mechanical bookkeeping (Haiku-level, no synthesis). The
17+
value accumulates on every subsequent "what about X" query thereafter:
18+
ledger-first, code-never-unless-necessary.
19+
20+
Cross-ref: PR #213 (lance-graph, 41 prompts × merged PRs), PR #110
21+
(ndarray, 25 prompts × merged PRs). Both shipped in ~90s on a dumb
22+
enumerate+match+append loop. No code reads, no MCP, no synthesis.

0 commit comments

Comments
 (0)