Split the documentation by who reads it

README.md was 577 lines and answered four different questions at once: what
the project is, how to build it, every verb and function in the language, and
how to maintain the test harness. The verb and function lists had already been
written a second time in docs/11 and docs/12, which is how a list of that size
goes stale -- there is no way to notice the two have drifted apart.

README.md is now 150 lines and holds only what somebody evaluating the project
needs: what it is, the quickstart, why it was rewritten in C, the five rules
embedding imposes on the design, the two ways to use it, and where everything
else lives. Technical detail goes to docs/, maintenance to MAINTENANCE.md.

The akbasic_TextSink struct moved to docs/10-embedding.md rather than being
deleted. It was the corpus's only `c excerpt=` block -- the check that caught
the stale struct two commits ago -- so dropping it with the README would have
quietly retired a test. docs/10 also stopped claiming README.md carries the
full API surface and the pool limits, which the trim made false.

CLAUDE.md went from 458 lines to 62, because almost none of it was
agent-specific. The project goals, the Go reference and its architecture, the
dependency version and ABI rules, the four ways an embedded build collides,
the libakerror convention, the error-code range map and the style rules are
all things a maintainer needs, and they are now in MAINTENANCE.md with one
copy to keep true. CLAUDE.md points there and keeps only the rules no test
enforces: tests in the same commit asserting the correct contract, file a
missing dependency capability upstream, do not edit generated output or
tests/reference/, co-author your commits.

Four claims did not survive the move, having gone stale where nothing could
notice:

  - "The repository is currently empty apart from its submodules -- no
    commits, no source tree, no build files." There are 43 commits.
  - libakgl's target_compile_definitions(akerror PUBLIC AKERR_MAX_ERR_VALUE)
    at deps/libakgl/CMakeLists.txt:44, described as inert but present. It is
    gone; only a historical mention in a comment remains.
  - "akbasic_init() claims 512-767." There is no akbasic_init. It is
    akbasic_error_register(), called from akbasic_runtime_init().
  - Time-relative phrasing ("libakgl hit two of them in the last week").

Five places pointed at CLAUDE.md for the range map or the file-it-upstream
rule and now point at MAINTENANCE.md: include/akbasic/error.h,
src/runtime_disk.c and three entries in TODO.md. Both source changes are
comments. deps/libakgl/TODO.md cites it too and is left alone; it is a
submodule, and the rule it quotes is still reachable from CLAUDE.md.

ctest is green at 95 of 95, docs_examples included: 36 programs, 9
transcripts, 44 output comparisons, 3 C snippets, 1 excerpt.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

TODO.md

@@ -39,8 +39,8 @@ What it does **not** change:
 
 **Read these before touching anything**, in this order:
 
-1. `CLAUDE.md` in this repository — project goals, the `libakerror` convention, the error-code
-   range map, and the dependency versions.
+1. `MAINTENANCE.md` in this repository — project goals, the `libakerror` convention, the
+   error-code range map, and the dependency versions.
 2. `deps/libakerror/AGENTS.md` — the `ATTEMPT`/`CLEANUP`/`PROCESS`/`HANDLE`/`FINISH` protocol.
 3. `deps/libakerror/UPGRADING.md` — 1.0.0's status registry. Required before writing an error
    code; the mechanism it replaced is gone.
@@ -213,7 +213,7 @@ output.**
 ### 1.7 Error codes are absolute, reserved from the 1.0.0 registry
 
 `deps/libakerror` is at **1.0.0**. Read `deps/libakerror/UPGRADING.md` before writing an error
-code; `CLAUDE.md`'s error-code section is the condensed version. Three things this changes
+code; `MAINTENANCE.md`'s error-code section is the condensed version. Three things this changes
 from what you may have seen in an older draft or in `libakgl`:
 
 - `AKERR_MAX_ERR_VALUE` **no longer exists**. The name registry is sparse and takes any `int`.
@@ -221,9 +221,10 @@ from what you may have seen in an older draft or in `libakgl`:
   one, delete it.
 - `__AKERR_ERROR_NAMES` **no longer exists**. The table is private.
 - Codes are **absolute integer constants at 256 or above**, never `AKERR_LAST_ERRNO_VALUE + N`.
-  The offset scheme is what produced the live `libakgl` collision documented in `CLAUDE.md`.
+  The offset scheme is what produced the live `libakgl` collision documented in
+  `MAINTENANCE.md`.
 
-`akbasic` owns **512–767** per the range map in `CLAUDE.md`. Declare it as an `enum`, so the
+`akbasic` owns **512–767** per the range map in `MAINTENANCE.md`. Declare it as an `enum`, so the
 values stay compile-time integer constants (`HANDLE` expands to `case` labels, which require
 that) and adding a code does not mean renumbering an offset: