# 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:`.