docs: generate + verify project documentation — canonical docs, per-package READMEs, verified fix pass

- New: docs/ARCHITECTURE.md, docs/GETTING-STARTED.md, docs/DEVELOPMENT.md,
  docs/TESTING.md, docs/CONFIGURATION.md (colored mermaid diagrams, quoted labels)
- Regenerated README.md (arah² / arah2bot naming, canonical clone URL)
- New per-package READMEs: theme/, bot/, web/
- Verified 13 docs against the live codebase (2 fix iterations + 2 residual
  corrections); corrected 56 stale claims across AGENTS/DESIGN/IDEAS/GSD_FIX

GSD_FIX.md

@@ -27,8 +27,8 @@ This layout predates OpenCode V2's command discovery rules. In V2, nested paths
 
 Verified against the running service via `opencode api get /api/command`: every command was
 registered as `gsd/gsd-*`, so typing `/gsd-*` found nothing — they "seemed" missing even though
-the files were all present (the installer's `gsd-opencode check` reported 755/755 files intact,
-which is exactly why the health check did not catch this).
+the files were all present (the installer's `gsd-opencode check` reported 755/843 files verified
+— 755 passing out of the 843-file manifest — which is exactly why the health check did not catch this).
 
 **Fix:** flattened the command files:
 
@@ -63,15 +63,16 @@ Verified with `gsd-sdk query state.load` (succeeds) and `gsd-sdk --version`.
 
 ## Side notes
 
-- `which gsd-opencode` also resolved to a **Windows npm shim** (`/mnt/c/Users/.../npm/gsd-opencode`)
-  on the WSL PATH from a previous install on the Windows side. Harmless but confusing; the Linux
-  binaries under `~/.nvm/.../bin` now take precedence for `gsd-sdk`.
+- At the time of this repair, `which gsd-opencode` also resolved to a **Windows npm shim**
+  (under `/mnt/c/Users/.../npm/`) on the WSL PATH, from a previous install on the Windows side.
+  Harmless but confusing; the Linux binaries under `~/.nvm/.../bin` now take precedence for
+  `gsd-sdk`. That shim has since been removed and is no longer on the current PATH.
 - The installer's own health checker (`gsd-opencode check`) still expects the old nested
   `commands/gsd/` layout and will report the 88 flattened files as "missing" — this is a false
   positive caused by the checker not knowing about OpenCode V2's namespacing rules. The files
   are fine where OpenCode can find them.
 - After changing GSD model profiles, note the package requires a full OpenCode restart
-  (agent→model mappings come from `opencode.json` and are read at startup).
+  (agent→model mappings come from `opencode.jsonc` and are read at startup).
 
 ## Current state