docs: add aspid-wiki knowledge wiki (EN + RU vaults + skill) - #115
Draft
VPDPersonal wants to merge 4 commits into
Draft
docs: add aspid-wiki knowledge wiki (EN + RU vaults + skill)#115VPDPersonal wants to merge 4 commits into
VPDPersonal wants to merge 4 commits into
Conversation
- New `aspid-wiki` skill (Ingest/Query/Lint/Export) with submodule-aware git-diff sync and an English-source / translated-vault model. - `docs/wiki/` — 67-page Obsidian vault generated from the codebase (concepts, entities, flows, generation, risks, reference, converters, 33 binder categories); human-readable filenames + `[[wikilinks]]`. - `docs/wiki-ru/` — full Russian translation mirroring the English tree 1:1; English remains the single source of truth. - Wire-up: `.gitignore` ignores Obsidian working state; `CLAUDE.md` points contributors at the wiki.
- Generalize the ignore glob to docs/wiki*/.obsidian so docs/wiki-ru (and future translations) also skip per-user UI state. - Untrack the docs/wiki-ru workspace.json that slipped into the prior commit.
VPDPersonal
added
type: documentation
The catalog was written during scaffold before the per-category pages existed, so only Text was linked. Now that all 33 category pages exist, turn every category into a [[wikilink]] (EN + RU) and drop the stale "pages still to create" note.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
aspid-wiki, a Claude Code skill (Ingest / Query / Lint / Export) that builds and maintains a navigable knowledge base of the framework. It uses a submodule-aware git-diff checkpoint for cheap incremental re-ingest (the source generators live in submodules, so the superproject diff alone misses their changes) and an English-source / translated-vault model.docs/wiki/— a 67-page English Obsidian vault generated from the codebase: overview, concepts, entities, flows, the source-generation pipeline, risks, reference, converters, and 33 binder categories. Pages are concise, link-checked, and carrysource_pathsback to code; filenames are human-readable and cross-linked with[[wikilinks]].docs/wiki-ru/— a full 1:1 Russian translation mirroring the English tree. English is the single source of truth; translations are regenerated from it (see the skill'sreferences/translations.md). The model extends to further languages asdocs/wiki-<lang>/..gitignoreignores per-user Obsidian working state for alldocs/wiki*vaults (shared graph/appearance config stays tracked);CLAUDE.mdpoints contributors at the wiki.Why: re-establishing codebase context from raw source costs ~5–15k tokens per session before any work begins. Orienting from a few wiki pages instead of reading hundreds of
.csfiles cuts that cost for both agents and developers.Notes for review
[[wikilinks]]), but pages should be spot-checked for technical accuracy before this is marked ready.docs/wiki/(ordocs/wiki-ru/);docs/wiki/index.mdis the hub.index.md(last_commit+submodule_commits) is set to this branch's base, so the next incremental Ingest only processes changes after it.🇷🇺 Описание на русском
Summary
aspid-wiki— скилл Claude Code (Ingest / Query / Lint / Export), который строит и поддерживает навигируемую базу знаний по фреймворку. Использует submodule-aware git-diff чекпоинт для дешёвого инкрементального ре-инжеста (source-генераторы живут в сабмодулях, и дифф суперпроекта их изменений не видит) и модель «английский — источник / переводные vault'ы».docs/wiki/— английский Obsidian-vault на 67 страниц, сгенерированный из кодовой базы: обзор, концепции, сущности, флоу, пайплайн source-генерации, риски, референс, конвертеры и 33 категории биндеров. Страницы компактны, ссылки проверены, каждая несётsource_pathsк коду; имена файлов человекочитаемы и связаны[[wikilinks]].docs/wiki-ru/— полный 1:1 русский перевод, зеркалящий английское дерево. Единственный источник истины — английский; переводы регенерируются из него (см.references/translations.mdскилла). Модель расширяется на другие языки какdocs/wiki-<lang>/..gitignoreигнорирует пер-пользовательское рабочее состояние Obsidian для всех vault'овdocs/wiki*(общий конфиг графа/внешнего вида остаётся под трекингом);CLAUDE.mdнаправляет контрибьюторов в вики.Зачем: восстановление контекста кодовой базы из сырых исходников стоит ~5–15k токенов на сессию ещё до начала работы. Ориентация по нескольким страницам вики вместо чтения сотен
.cs-файлов срезает эту цену и агентам, и разработчикам.Notes for review
[[wikilinks]]), но перед переводом в ready страницы стоит выборочно проверить на техническую точность.docs/wiki/(илиdocs/wiki-ru/); хаб —docs/wiki/index.md.index.md(last_commit+submodule_commits) выставлен на базу этой ветки, так что следующий инкрементальный Ingest обработает только изменения после неё.