denysm/wiki-kit

Tools and rules for running a personal knowledge wiki on the nvk/llm-wiki plugin with an AI coding assistant. The kit contains no data: only the method.
Status: draft. Merged from two working copies (work and home). The installers are tested on clean Ubuntu and Windows machines in CI (.github/workflows/installers.yml) and on macOS with an empty home folder; not yet by a real new user.
New here? Follow docs/QUICKSTART.md (по-русски, українською): VS Code, Claude Code, then bash bootstrap.sh (Windows: bootstrap.ps1).
Want to improve it? Send a pull request: CONTRIBUTING.md.
| Folder | What it is |
| bootstrap.ps1 | The same for Windows 10/11; also installs Git, Python and Claude Code if missing (asks first); log in %TEMP%\wiki-kit-bootstrap.log. Tested in CI on a clean Windows machine (Windows PowerShell 5.1) |
| bootstrap.sh | Installer for macOS and Linux: plugin pinned to v1.0.0, empty hub, private lists, specialists, front desk, self-check; safe to re-run |
| docs/QUICKSTART.md, docs/QUICKSTART.ru.md, docs/QUICKSTART.uk.md | Plain-language install, first steps and how to send improvements, in English, Russian and Ukrainian |
| CONTRIBUTING.md, .github/pull_request_template.md | How to send a change by pull request, and the privacy checklist every pull request starts with |
| .github/workflows/ | CI: checks on every push (scripts compile on Python 3.9 and 3.13, leak check over the whole history without the private names list, shell syntax, no symlinks); installers runs both installers twice on clean Ubuntu and Windows and checks that the pre-push hook blocks a fake key |
| docs/PROJECT-CONTEXT.md | Goals, key decisions and roadmap of this project (read first) |
| docs/ai-tooling-for-throwaway-pocs.md | Choosing AI delivery tooling for throwaway PoCs: four layers, verdict template, when to run what |
| docs/testing-specialists.md | How to test a specialist against the no-specialist baseline before 1.0 |
| docs/llm-wiki-portable-playbook.md | The method in full: layout, frontmatter, ADRs, confidentiality, cost, quality gates, cold start |
| templates/hub-CLAUDE.md | Starting rules for a new hub (fill in the {...} placeholders) |
| templates/specialist/ | Skeleton for a new specialist with the department rules built in |
| agents/ | wiki-reader (read-only digests) and wiki-compiler (ingest + compile one topic), plus the shared COMMON.md |
| scripts/ | Python helpers, listed below; standard library only, except numpy for search.py (search.py install-deps, run by the installers) |
| specialists/ | The specialist department: 11 specialists in five divisions (growth, wellbeing, family, money and documents, thinking tools); staff, rules and vacancies in specialists/README.md |
| skills/department/ | Claude Code skill: the front desk that asks your language, picks a specialist by a plain phrase ("coach", "мне тяжело") and hands over between them |
| skills/foreman/ | Claude Code skill: the foreman for work that needs a team ("assemble a team", "наряд"): recalls past work orders and lessons first (search.py recall), work order, staffing table with measured cost estimates (scripts/roster.py), hires only after your yes, quality control, acceptance, lessons, and an order record in the topic's output/work-orders/ for the next recall |