refactor(wiki): migrate this repo's .wiki/ to canonical Karpathy layout
Stop being inconsistent with our own fixed project-bootstrap template. - SUMMARY.md → index.md (catalog by type, with one-line hooks) - source/*.md → concepts/*.md (with `git mv` so history is preserved) - WORKFLOW.md removed (workflow lives in wiki-maintainer, not duplicated here) - New: .wiki/CLAUDE.md (project schema, Karpathy gist URL pinned at top) - New: log.md (append-only op log; backfilled with prior decisions) - New: overview.md (single project intro page) - New: raw/README.md (immutability note; replaces .gitkeep placeholder) - Empty .gitkeep added to entities/, packages/, sources/ - Migrated pages got `type: concept` frontmatter After this, wiki-maintainer reads .wiki/CLAUDE.md → index.md as it expects, and the layout matches what newly-bootstrapped projects will look like. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
40
.wiki/CLAUDE.md
Normal file
40
.wiki/CLAUDE.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# Wiki Schema — claude-skills
|
||||
|
||||
Project-specific wiki conventions. Read this before any wiki operation.
|
||||
|
||||
This wiki follows Karpathy's LLM Wiki pattern:
|
||||
**https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f**
|
||||
|
||||
The `wiki-maintainer` skill enforces the workflow and file formats. This file overrides the skill where they conflict.
|
||||
|
||||
## Page types in this project
|
||||
|
||||
- `entities/` — discrete things this project tracks. Reserved for future use (individual skills if they accumulate non-obvious context, tools we adopt).
|
||||
- `concepts/` — design decisions, technical gotchas, refactor notes. Most pages live here.
|
||||
- `packages/` — currently empty. Would be used if we extract a package (e.g. a CLI) from this repo.
|
||||
- `sources/` — one summary per ingested external doc; carries `ingested:` and `raw_path:` frontmatter.
|
||||
- `overview.md` — single project-wide overview. Read this first if new to the repo.
|
||||
|
||||
## Naming
|
||||
|
||||
- `kebab-case.md`, **Latin only**. Transliterate Cyrillic in filenames; keep the original title in the H1 + frontmatter.
|
||||
|
||||
## Domain conventions
|
||||
|
||||
- Skill-related design notes go in `concepts/<skill-name>-*.md` (e.g. `active-platform-decision.md`).
|
||||
- Build / install pipeline notes live in `concepts/build-*.md`.
|
||||
- Refactor / re-alignment commits get a `concepts/<what>-realignment.md` page.
|
||||
|
||||
## Frontmatter
|
||||
|
||||
Minimum:
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: Human-readable title
|
||||
type: concept | entity | package | source | overview
|
||||
updated: YYYY-MM-DD
|
||||
---
|
||||
```
|
||||
|
||||
`source/` pages also carry `ingested:` and `raw_path:`.
|
||||
@@ -1,11 +0,0 @@
|
||||
# Wiki Summary
|
||||
|
||||
List of all pages in source/ with one-line descriptions.
|
||||
The agent updates this file whenever source/ changes.
|
||||
|
||||
## Pages
|
||||
|
||||
- [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`
|
||||
@@ -1,15 +0,0 @@
|
||||
# Wiki Workflow
|
||||
|
||||
This wiki follows Karpathy's method: knowledge accumulates rather than being re-derived.
|
||||
|
||||
## Rules for the agent
|
||||
|
||||
- **Before starting work** — read relevant pages from source/
|
||||
- **After an important decision** — update or create a page in source/
|
||||
- **New raw materials** (links, docs, transcripts) — put in raw/
|
||||
- **Processed knowledge** — write as markdown pages in source/
|
||||
- **SUMMARY.md** — update whenever a page is added to source/
|
||||
|
||||
## Trigger
|
||||
|
||||
Skill is activated by the phrase: **use project wiki**
|
||||
@@ -1,3 +1,9 @@
|
||||
---
|
||||
title: "Decision: active-platform skill"
|
||||
type: concept
|
||||
updated: 2026-04-28
|
||||
---
|
||||
|
||||
# Decision: `active-platform` skill
|
||||
|
||||
_2026-04-28._
|
||||
@@ -1,3 +1,9 @@
|
||||
---
|
||||
title: Build Notes
|
||||
type: concept
|
||||
updated: 2026-04-28
|
||||
---
|
||||
|
||||
# Build Notes
|
||||
|
||||
Practical gotchas around building `.skill` archives.
|
||||
@@ -1,3 +1,9 @@
|
||||
---
|
||||
title: Repo Layout & Skill Workflow
|
||||
type: concept
|
||||
updated: 2026-04-28
|
||||
---
|
||||
|
||||
# Repo Layout & Skill Workflow
|
||||
|
||||
_Decision: 2026-04-28. Approved by Vitya in chat._
|
||||
@@ -1,3 +1,9 @@
|
||||
---
|
||||
title: Wiki realignment to Karpathy canon
|
||||
type: concept
|
||||
updated: 2026-04-28
|
||||
---
|
||||
|
||||
# Wiki realignment to Karpathy canon
|
||||
|
||||
_2026-04-28._
|
||||
26
.wiki/index.md
Normal file
26
.wiki/index.md
Normal file
@@ -0,0 +1,26 @@
|
||||
# Wiki Index
|
||||
|
||||
Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page.
|
||||
|
||||
## Overview
|
||||
|
||||
- [overview.md](overview.md) — what claude-skills is, layout, how to navigate
|
||||
|
||||
## Entities
|
||||
|
||||
<!-- (none yet) -->
|
||||
|
||||
## Concepts
|
||||
|
||||
- [active-platform-decision.md](concepts/active-platform-decision.md) — why `active-platform` is a skill (not a memory entry); why default = Windows; how it's wired into `project-bootstrap`
|
||||
- [build-notes.md](concepts/build-notes.md) — why `build.ps1` exists alongside `build.sh`; PS 5.1 backslash-in-zip gotcha; how to extract a `.skill`
|
||||
- [repo-layout.md](concepts/repo-layout.md) — flat `skills/`, committed `dist/`, bash + PowerShell scripts; install model
|
||||
- [wiki-realignment.md](concepts/wiki-realignment.md) — fixing `project-bootstrap` to create the Karpathy-canonical wiki layout
|
||||
|
||||
## Packages
|
||||
|
||||
<!-- (none yet) -->
|
||||
|
||||
## Sources
|
||||
|
||||
<!-- (none yet) -->
|
||||
20
.wiki/log.md
Normal file
20
.wiki/log.md
Normal file
@@ -0,0 +1,20 @@
|
||||
# Wiki Log
|
||||
|
||||
Append-only operation log. One entry per operation. Format:
|
||||
|
||||
```
|
||||
## [YYYY-MM-DD] <op> | <one-line description>
|
||||
```
|
||||
|
||||
Operations: `init`, `ingest`, `query`, `lint`, `refactor`, `decision`.
|
||||
|
||||
Parseable: `grep "^## \[" .wiki/log.md | tail -20`.
|
||||
|
||||
---
|
||||
|
||||
## [2026-04-28] init | bootstrap empty wiki via project-bootstrap (old layout)
|
||||
## [2026-04-28] decision | repo-layout — flat `skills/`, committed `dist/`, bash + PS scripts
|
||||
## [2026-04-28] decision | build-notes — PS 5.1 Compress-Archive backslash bug; build.ps1 via .NET ZipArchive
|
||||
## [2026-04-28] decision | active-platform — skill chosen over global CLAUDE.md / project memory; default Windows; wired into project-bootstrap
|
||||
## [2026-04-28] refactor | wiki-realignment — fixed project-bootstrap Step 3 to create Karpathy-canonical layout
|
||||
## [2026-04-28] refactor | this repo's `.wiki/` migrated to canonical layout (SUMMARY.md→index.md, source/→concepts/, added log.md/overview.md/CLAUDE.md schema, raw/README.md)
|
||||
29
.wiki/overview.md
Normal file
29
.wiki/overview.md
Normal file
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: claude-skills overview
|
||||
type: overview
|
||||
updated: 2026-04-28
|
||||
---
|
||||
|
||||
# claude-skills — overview
|
||||
|
||||
Joint workshop where Vitya and Claude develop, test, and store Claude skills. Both editable sources (`skills/<name>/`) and built archives (`dist/<name>.skill`) live here, so a fresh machine can clone the repo and install every personal skill in one command.
|
||||
|
||||
## Components
|
||||
|
||||
- **`skills/`** — editable skill sources, one folder per skill (each with `SKILL.md` + optional `assets/`).
|
||||
- **`dist/`** — built `.skill` archives, committed so installs don't need a build toolchain on the target.
|
||||
- **`scripts/`** — `build.sh` / `build.ps1` (zip sources → archive), `install.sh` (copy sources → `~/.claude/skills/`).
|
||||
- **`.wiki/`** — Karpathy LLM Wiki for design decisions and gotchas. See [CLAUDE.md](CLAUDE.md) for schema.
|
||||
- **`.tasks/`** — task board (`STATUS.md`).
|
||||
- **`CLAUDE.md`** — repo-level agent instructions (skill triggers).
|
||||
|
||||
## Where to look
|
||||
|
||||
- New here? → [concepts/repo-layout.md](concepts/repo-layout.md), then `README.md`.
|
||||
- Working on a skill? → edit `skills/<name>/`, then `bash scripts/install.sh <name>` (or `pwsh scripts/build.ps1 <name>` to refresh the archive).
|
||||
- Tracking work? → [.tasks/STATUS.md](../.tasks/STATUS.md).
|
||||
- Made a non-trivial decision? → add a `concepts/<topic>.md` page, link from [index.md](index.md), append a line to [log.md](log.md).
|
||||
|
||||
## Cross-references
|
||||
|
||||
This page intentionally stays short. The substantive material lives in `concepts/` (decisions, gotchas) and the [index](index.md) catalog.
|
||||
13
.wiki/raw/README.md
Normal file
13
.wiki/raw/README.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# Raw Sources
|
||||
|
||||
**Immutable.** Read, never edit. The only allowed modification is appending a `> Status:` blockquote when the user explicitly asks for a status audit.
|
||||
|
||||
Place raw inputs here — articles, transcripts, PDFs, screenshots — exactly as they came in. The agent reads from `raw/`, writes summaries into `../sources/`, and never modifies raw files.
|
||||
|
||||
For large or path-sensitive sources outside the repo, register them here:
|
||||
|
||||
```
|
||||
- short-name → /absolute/path/to/source
|
||||
```
|
||||
|
||||
Currently: no raw sources yet.
|
||||
0
.wiki/sources/.gitkeep
Normal file
0
.wiki/sources/.gitkeep
Normal file
Reference in New Issue
Block a user