fix(project-bootstrap): align wiki init with Karpathy canon

Bootstrap was creating .wiki/SUMMARY.md + WORKFLOW.md + source/ — none of
which match Karpathy's LLM Wiki pattern or what wiki-maintainer reads first.
The skill had to bend around an invented layout (no schema file, wrong
catalog name, missing log/overview/entities/concepts/packages).

Rewrote Step 3 to create the canonical layout verbatim:
  .wiki/CLAUDE.md          schema (project-specific conventions)
  .wiki/index.md           catalog
  .wiki/log.md             append-only op log
  .wiki/overview.md        project overview
  .wiki/raw/README.md      immutability note
  .wiki/{entities,concepts,packages,sources}/.gitkeep

Pinned the gist URL inside the schema:
  https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

Bumped dist/project-bootstrap.skill, recorded the why in
.wiki/source/wiki-realignment.md, and queued migration of *this* repo's own
.wiki/ (still on the old layout) as a backlog task — to be done deliberately.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-28 11:17:36 +03:00
parent af94830fd5
commit 1cae0a2cf3
5 changed files with 167 additions and 22 deletions

View File

@@ -8,3 +8,4 @@ The agent updates this file whenever source/ changes.
- [repo-layout.md](source/repo-layout.md) — how the repo is organized: `skills/` sources, `dist/` builds, `scripts/` build & install
- [build-notes.md](source/build-notes.md) — why `build.ps1` exists, ZIP layout, PowerShell 5.1 backslash gotcha
- [active-platform-decision.md](source/active-platform-decision.md) — why we made `active-platform` a skill instead of a memory entry
- [wiki-realignment.md](source/wiki-realignment.md) — fixed `project-bootstrap` to create the Karpathy-canonical wiki layout (`index.md`/`log.md`/schema), not the bogus `SUMMARY.md`+`WORKFLOW.md`

View File

@@ -0,0 +1,50 @@
# Wiki realignment to Karpathy canon
_2026-04-28._
## What was wrong
`project-bootstrap` Step 3 was creating `.wiki/SUMMARY.md`, `WORKFLOW.md`,
and a `source/` folder. **None of these match** Karpathy's LLM Wiki pattern
or what the `wiki-maintainer` skill reads:
| Bootstrap created | Canon expects |
|---|---|
| `SUMMARY.md` | `index.md` |
| `WORKFLOW.md` (duplicates skill) | (no such file — workflow lives in `wiki-maintainer`) |
| `source/` (singular) | `sources/` (plural) |
| (missing) | `.wiki/CLAUDE.md` schema |
| (missing) | `log.md` (append-only op log) |
| (missing) | `entities/`, `concepts/`, `packages/`, `overview.md` |
| (missing) | `raw/README.md` |
When `wiki-maintainer` triggered, it had to bend around an invented layout:
the schema file it expects to read first wasn't there at all, and the
catalog had the wrong name.
## Fix
Rewrote `project-bootstrap` Step 3 to create the canonical layout verbatim:
```
.wiki/
CLAUDE.md schema (project-specific conventions)
index.md catalog of all pages
log.md append-only op log: ## [YYYY-MM-DD] op | desc
overview.md single human-readable project overview
raw/README.md raw/ is immutable; this documents that
entities/ concepts/ packages/ sources/ (with .gitkeep)
```
Each file has its initial content baked into the SKILL.md so bootstrap can
write them without external assets.
The Karpathy gist is pinned at the top of `.wiki/CLAUDE.md`:
**https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f**
## What about this repo's `.wiki/`?
This repo was itself bootstrapped with the old buggy layout. Its `.wiki/`
still uses `SUMMARY.md` + `source/`. Migrating to canon is a directory
rename + file moves; queued as a backlog task to do consciously rather than
silently bundling it here.