From 2a37e33fd6b1f224b72524f90fc9223da6a1a682 Mon Sep 17 00:00:00 2001 From: Eric Turner Date: Sun, 12 Apr 2026 21:42:11 -0600 Subject: [PATCH] docs: point Signal & Noise links at self-hosted version MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replace all four references to the Claude public artifact URL with the self-hosted version at eric-turner.com/memex/signal-and-noise.html plus the offline-capable archive at docs/artifacts/signal-and-noise.html. The Claude artifact can now be unpublished without breaking any links in the repo. The self-hosted HTML is deployed to the Hugo site's static directory and lives alongside the archived copy in this repo — either can stand on its own. --- README.md | 20 ++++++++++---------- docs/DESIGN-RATIONALE.md | 18 ++++++++++++------ 2 files changed, 22 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index b3692cf..2d42e9c 100644 --- a/README.md +++ b/README.md @@ -103,8 +103,8 @@ keeping cross-references intact, and flagging ambiguity for review. ## Why each part exists Before implementing anything, the design was worked out interactively -with Claude as a [Signal & Noise analysis of Karpathy's -pattern](https://claude.ai/public/artifacts/0f6e1d9b-3b8c-43df-99d7-3a4328a1620c). +with Claude as a +[Signal & Noise analysis of Karpathy's pattern](https://eric-turner.com/memex/signal-and-noise.html). That analysis found seven real weaknesses in the core pattern. This repo exists because each weakness has a concrete mitigation — and every component maps directly to one: @@ -414,20 +414,20 @@ and how to adapt for other agents). **Design process** — this repo was designed interactively with Claude as a structured Signal & Noise analysis before any code was written. The analysis walks through the seven real strengths and seven real -weaknesses of the core pattern, then works through concrete mitigations -for each weakness. Every component in this repo maps back to a specific -mitigation identified there. +weaknesses of Karpathy's pattern, then works through concrete +mitigations for each weakness. Every component in this repo maps back +to a specific mitigation identified there. - **Live interactive version**: [eric-turner.com/memex/signal-and-noise.html](https://eric-turner.com/memex/signal-and-noise.html) - (click tabs to explore pros/cons, vs RAG, use-case fits, signal - breakdown, and mitigations) -- **Original Claude artifact**: - [The LLM Wiki — Karpathy's Pattern — Signal & Noise](https://claude.ai/public/artifacts/0f6e1d9b-3b8c-43df-99d7-3a4328a1620c) -- **Archived copy in this repo**: + — click tabs to explore pros/cons, vs RAG, use-case fits, signal + breakdown, and mitigations +- **Self-contained archive in this repo**: [`docs/artifacts/signal-and-noise.html`](docs/artifacts/signal-and-noise.html) + — download and open locally; works offline - **Condensed written version**: [`docs/DESIGN-RATIONALE.md`](docs/DESIGN-RATIONALE.md) + — every tradeoff and mitigation rendered as prose --- diff --git a/docs/DESIGN-RATIONALE.md b/docs/DESIGN-RATIONALE.md index b9c3487..82d1349 100644 --- a/docs/DESIGN-RATIONALE.md +++ b/docs/DESIGN-RATIONALE.md @@ -7,13 +7,17 @@ Before implementing anything, the design was worked out interactively with Claude as a structured Signal & Noise analysis of Andrej Karpathy's original persistent-wiki pattern: -> **Interactive design artifact**: [The LLM Wiki — Karpathy's Pattern — Signal & Noise](https://claude.ai/public/artifacts/0f6e1d9b-3b8c-43df-99d7-3a4328a1620c) +> **Interactive version**: [eric-turner.com/memex/signal-and-noise.html](https://eric-turner.com/memex/signal-and-noise.html) +> — tabs for pros/cons, vs RAG, use-case fits, signal breakdown, mitigations +> +> **Self-contained archive**: [`artifacts/signal-and-noise.html`](artifacts/signal-and-noise.html) +> — same content, works offline -That artifact walks through the pattern's seven genuine strengths, seven +The analysis walks through the pattern's seven genuine strengths, seven real weaknesses, and concrete mitigations for each weakness. This repo is the implementation of those mitigations. If you want to understand -*why* a component exists, the artifact has the longer-form argument; this -document is the condensed version. +*why* a component exists, the interactive version has the longer-form +argument; this document is the condensed written version. --- @@ -330,8 +334,10 @@ architecture is probably what you need. — the concept - [mempalace](https://github.com/milla-jovovich/mempalace) — the structural memory layer -- [Signal & Noise interactive analysis](https://claude.ai/public/artifacts/0f6e1d9b-3b8c-43df-99d7-3a4328a1620c) - — the design rationale this document summarizes +- [Signal & Noise interactive analysis](https://eric-turner.com/memex/signal-and-noise.html) + — the design rationale this document summarizes (live interactive version) +- [`artifacts/signal-and-noise.html`](artifacts/signal-and-noise.html) + — self-contained archive of the same analysis, works offline - [README](../README.md) — the concept pitch - [ARCHITECTURE.md](ARCHITECTURE.md) — component deep-dive - [SETUP.md](SETUP.md) — installation