87 lines
4.4 KiB
Markdown
87 lines
4.4 KiB
Markdown
# wiki-context
|
|
|
|
**Planning workspace** for the `wiki-construct` project — the design
|
|
conversation and decision history behind Travis's personal LLM-maintained
|
|
wiki. This repo holds the planning docs and the bundled
|
|
`wiki-maintenance` skill files, not the wiki itself.
|
|
|
|
The actual wiki lives in [`../wiki-vault/`](../wiki-vault). Operate on
|
|
the live vault there; come here to understand *why* it's shaped the way
|
|
it is.
|
|
|
|
## Layout
|
|
|
|
```
|
|
wiki-context/
|
|
├── CLAUDE.md # Early draft spec (frozen, superseded
|
|
│ # by wiki-vault/CLAUDE.md)
|
|
├── wiki-construct-project-plan.md # Project plan with locked decisions
|
|
├── wiki-construct-context.md # Design rationale + reasoning history
|
|
├── skill/ # wiki-maintenance skill, split into files
|
|
│ ├── skill-wiki.md # = SKILL.md (in sync with installed)
|
|
│ ├── compile.md # compile procedure (in sync with installed)
|
|
│ ├── lint.md # lint procedure
|
|
│ ├── migration.md # one-time migration runbook
|
|
│ └── README.md # bundle deploy preamble
|
|
└── README.md # This file
|
|
```
|
|
|
|
## What's in each doc
|
|
|
|
| File | What it captures |
|
|
|------|------------------|
|
|
| `wiki-construct-context.md` | The *why* — the two converging conversations that produced the project, the wiki-vs-OB1 framing decision, why flat structure won, etc. The load-bearing context that future Claude sessions in this project space should read first. |
|
|
| `wiki-construct-project-plan.md` | The *what* — locked decisions, phases, tasks. Treated as a project plan, with frontmatter matching the wiki spec. |
|
|
| `CLAUDE.md` | Early draft of the wiki spec. **Frozen** as a design-history record. The vault that actually got built has a different shape — see `wiki-vault/CLAUDE.md` for the canonical current spec. |
|
|
| `skill/` | The `wiki-maintenance` skill bundle, split into its four real files (`skill-wiki.md` = SKILL.md, `compile.md`, `lint.md`, `migration.md`) plus a deploy-preamble `README.md`. `compile.md` and `skill-wiki.md` were backported from the installed skill at `~/.claude/skills/wiki-maintenance/` on 2026-05-24 so the archive mirrors the live two-layer taxonomy. |
|
|
|
|
## How the design evolved
|
|
|
|
The early CLAUDE.md drafted here proposed:
|
|
|
|
- A **flat** per-domain structure (`HomeLab/Dev/*.md` etc.)
|
|
- Four domains: Dev / **Content** / Homelab / Reference
|
|
|
|
What actually shipped in `wiki-vault/`:
|
|
|
|
- A **two-layer** structure: `Sources/` (raw inputs) + `Wiki/`
|
|
(compiled outputs)
|
|
- Four domains: Dev / **Venture** / Homelab / Reference (Content
|
|
renamed)
|
|
- Vault-mcp writes into `Sources/` via `create_artifact`;
|
|
the `wiki-maintenance` skill compiles into `Wiki/`
|
|
|
|
Both shapes are valid Karpathy-style LLM-wikis — the live one made
|
|
explicit what the draft left implicit (the Sources-vs-Wiki distinction).
|
|
|
|
## Companion repos
|
|
|
|
- [`wiki-vault/`](../wiki-vault) — the live vault; canonical spec
|
|
+ content.
|
|
- `homelab/vault-mcp/` — the MCP server that writes to the live vault
|
|
(dual-writes Postgres `petalbrain.wiki` + markdown). It also
|
|
embeds note content via Ollama into `petalbrain.public.embeddings`.
|
|
|
|
## Status
|
|
|
|
The project moved from this workspace into deployed reality in May 2026.
|
|
This repo is kept around as the design archive. Open it when you need
|
|
the rationale behind a vault decision; otherwise reach for `wiki-vault/`.
|
|
|
|
**2026-05-24 session.** Split the single-file skill bundle into its four
|
|
real files and backported `compile.md` + `skill-wiki.md` from the
|
|
installed skill (the archived copies had drifted to the old flat-structure
|
|
draft). On the live vault, ran the first steady-state compile since launch
|
|
(34 backlogged sources → indexes + 5 entity refreshes + the
|
|
`ai-memory-architecture` synthesis, plus correcting the long-standing
|
|
"OB1 = Supabase" error to pgvector:pg17/`petalbrain`), the first lint pass,
|
|
promoted 5 new entities (trellis, vault-mcp, petalbrain, knot-dns,
|
|
herbyeos), and cleaned out 8 pipeline test artifacts + 3 stale worktrees.
|
|
A compile-cadence nudge (n8n → Google Chat, triggered off a
|
|
`wiki.compile_runs` table) was drafted to keep the vault from drifting
|
|
again — see `docker/n8n/workflows/wiki-compile-nudge.json`.
|
|
|
|
The leftover `main.py` / `pyproject.toml` / `uv.lock` / `.python-version`
|
|
files at the root are uv-init artifacts; they aren't part of this
|
|
workspace's purpose.
|