vitya
4382fd36b9
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>
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 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:`.
|