From c97d13f932b8de35ada51010b20365a72a5e063d Mon Sep 17 00:00:00 2001 From: Travis Herbranson Date: Sun, 24 May 2026 22:21:52 -0400 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E2=80=94=202026-05-24=20sessi?= =?UTF-8?q?on=20(skill=20split/backport,=20compile,=20lint,=20promotions,?= =?UTF-8?q?=20cadence=20draft)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.7 --- README.md | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 04a8bfd..1fba751 100644 --- a/README.md +++ b/README.md @@ -17,10 +17,12 @@ wiki-context/ │ # by wiki-vault/CLAUDE.md) ├── wiki-construct-project-plan.md # Project plan with locked decisions ├── wiki-construct-context.md # Design rationale + reasoning history -├── skill/ -│ └── skill-wiki.md # Bundle for the wiki-maintenance skill -│ # (SKILL.md + compile.md + lint.md + -│ # migration.md, copy-paste-ready) +├── 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 ``` @@ -31,7 +33,7 @@ wiki-context/ | `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/skill-wiki.md` | The contents of the `wiki-maintenance` skill bundle (4 files inside one for copy-paste deploy), used to populate `~/.claude/skills/wiki-maintenance/` on the host. | +| `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 @@ -66,6 +68,19 @@ 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.