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.
|
|
- `summaries/` — 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:`.
|