petal-power/wiki-context
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: README — 2026-05-24 session (skill split/backport, compile, lint, promotions, cadence draft)

Browse Source 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Travis Herbranson 2026-05-24 22:21:52 -04:00
parent 38f4431341
commit c97d13f932
1 changed files with 20 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
README.md
View File

@ -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.