docs: karpathy-pattern wiki built from the spec, plan, design contract and decisions ledger

kb/ is its own wiki root: 34 pages across 7 categories, index.md catalog, log.md, AGENTS.md schema layer, and raw/ holding copies of README, the spec, the 13-task plan, the design master and the SDD ledger.

Every page cross-references 3 to 6 others and all 107 wikilinks resolve except two [["list"]] artefacts inside JSON snippets in the copied plan.

Kept separate from the repository root on purpose: its generated graph lands in kb/.ua/ instead of overwriting the code graph.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
ahmed mohammed
2026-09-22 12:14:05 +03:00
co-authored by Claude Opus 4.7
parent 735a57bfd6
commit 8b42a0931c
42 changed files with 3534 additions and 0 deletions
+12
View File
@@ -0,0 +1,12 @@
# Container plan
`Dockerfile` is a multi-stage Node 25 build — Node 25 because `node:sqlite` is what the data layer uses — and
`docker-compose.yml` mounts a named volume at `/data` and reads `APP_SECRET` from the host environment.
The image is written but unbuilt on the development machine, which has no Docker. The build is therefore the
first thing to verify on a machine that has it: `bash scripts/smoke.sh --docker`.
Known rough edges carried forward deliberately: `.dockerignore` excludes tests but the image copies `node_modules`
including devDependencies, and a first real build may need a tweak.
Related: [[Running locally]], [[Smoke script]], [[Environment variables]].