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) │ # by wiki-vault/CLAUDE.md)
├── wiki-construct-project-plan.md # Project plan with locked decisions ├── wiki-construct-project-plan.md # Project plan with locked decisions
├── wiki-construct-context.md # Design rationale + reasoning history ├── wiki-construct-context.md # Design rationale + reasoning history
├── skill/ ├── skill/ # wiki-maintenance skill, split into files
│ └── skill-wiki.md # Bundle for the wiki-maintenance skill │ ├── skill-wiki.md # = SKILL.md (in sync with installed)
│ # (SKILL.md + compile.md + lint.md + │ ├── compile.md # compile procedure (in sync with installed)
│ # migration.md, copy-paste-ready) │ ├── lint.md # lint procedure
│ ├── migration.md # one-time migration runbook
│ └── README.md # bundle deploy preamble
└── README.md # This file └── 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-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. | | `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. | | `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 ## 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 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/`. 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` The leftover `main.py` / `pyproject.toml` / `uv.lock` / `.python-version`
files at the root are uv-init artifacts; they aren't part of this files at the root are uv-init artifacts; they aren't part of this
workspace's purpose. workspace's purpose.