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:
@@ -3,6 +3,14 @@ _Updated: 2026-04-28_
|
||||
|
||||
## Done
|
||||
|
||||
### project-bootstrap: align wiki init with Karpathy canon
|
||||
- [x] Read Karpathy gist + `wiki-maintainer` SKILL.md — gap confirmed
|
||||
- [x] Rewrite Step 3: create `index.md`, `log.md`, `overview.md`, `.wiki/CLAUDE.md` schema, `raw/README.md`, empty `entities/ concepts/ packages/ sources/` with `.gitkeep`
|
||||
- [x] Drop the bogus `SUMMARY.md` + `WORKFLOW.md` + `source/` from the template
|
||||
- [x] Pin Karpathy gist URL inside the schema file
|
||||
- [x] Rebuild + reinstall `project-bootstrap.skill`
|
||||
- [x] Document the realignment in `.wiki/source/wiki-realignment.md`
|
||||
|
||||
### project-bootstrap: include `active-platform` trigger in CLAUDE.md template
|
||||
- [x] Add `we're on Windows` line to `assets/CLAUDE.md.template`
|
||||
- [x] Update embedded preview in `SKILL.md` Step 5 (with note about Linux/macOS substitution)
|
||||
@@ -35,3 +43,4 @@ _Updated: 2026-04-28_
|
||||
- Decide whether to write a smoke-test that round-trips `skills/<name>/` → `dist/<name>.skill` → unpack → diff (would catch archive-shape regressions).
|
||||
- Tune `active-platform` triggers based on real-world usage; add WSL handling if it comes up.
|
||||
- Consider running formal `skill-creator` eval loop on `active-platform` once we have ~5 real interactions to learn from.
|
||||
- **Migrate this repo's `.wiki/` to the canonical Karpathy layout** (it was bootstrapped with the old buggy template). Directory rename + file moves; needs a conscious commit, not a silent piggyback.
|
||||
|
||||
Reference in New Issue
Block a user