Discoveries
What bassclef ran into and what it taught. Weekly write-ups including failure retrospectives.
Use this when
You want to see the pattern of what breaks and what bassclef learns from it. Discoveries are the "we learned this the hard way" record.
Skip this when
You are looking for a specific technical fix. That lives on the failure-mode playbook. Discoveries are narrative retrospectives; failure-mode is the runnable recipe.
Recent
- 2026-07-26 — CF token outage narrative flip — a 9-day production outage attributed to "gateway drift" that was really invalid token value on day 1. Assert-only-after-verify discipline pattern that this incident taught.
More discoveries land as they surface. Each one carries what happened, what the wrong theory was, what the right theory was, and what discipline it taught.
RSS
RSS feed lands in a follow-on ticket. Until then, subscribe via the weekly essay — every notable discovery from the week gets a "one thing learned" section.
ADR-001 — Docs framework
Fumadocs picked over Docusaurus, Nextra, Astro Starlight, and a custom Next.js build for docs.bassclef.dev.
2026-07-26 — CF token outage narrative flip
A 9-day production outage attributed to "gateway drift" that was really invalid token value on day 1. Assert-only-after-verify discipline pattern.