Architecture

Use this when

You are evaluating whether bassclef makes design decisions you can defend to your reviewer. Or you are debugging something at 2am and need to know what to check.

Skip this when

You are trying to install or use the framework. Read Get started first. Architecture pages are for the people who have to justify or debug the framework.

The pieces

• ADRs — architecture decisions with Context, Decision, Consequences, Rejected alternatives, Exit cost.
• Discoveries — weekly write- ups of what bassclef ran into and what it taught.
• Failure-mode playbook — six named failure classes with runnable diagnose commands.
• State spine — the authoritative state layer, JSON-on-git with typed accessors.
• Accessor library — lib/state.sh, the API every substrate consumer uses.
• Session log — the narrative record every substantive session produces.
• Whereami primitive — the singleton project-state snapshot.