Files

vitya 4382fd36b9 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>

2026-04-28 11:22:43 +03:00

1.5 KiB

Raw Blame History

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:

---
title: Human-readable title
type: concept | entity | package | source | overview
updated: YYYY-MM-DD
---

source/ pages also carry ingested: and raw_path:.

1.5 KiB Raw Blame History