petal-power/wiki-context
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
repo for storing the wiki-contents
3 Commits 2 Branches 0 Tags 67 KiB
Python 100%
38f4431341
Go to file
Travis Herbranson 38f4431341 docs: split skill bundle into separate files + backport live compile/SKILL updates 
Separated skill-wiki.md bundle into compile.md, lint.md, migration.md.
Backported compile.md and SKILL.md (skill-wiki.md) from the installed
skill at ~/.claude/skills/wiki-maintenance/ so the repo archive reflects
the shipped two-layer Sources/+Wiki/ taxonomy rather than the old flat draft.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 21:09:54 -04:00
skill docs: split skill bundle into separate files + backport live compile/SKILL updates 2026-05-24 21:09:54 -04:00
.gitignore init commit to create the project 2026-05-04 20:37:26 -04:00
.python-version init commit to create the project 2026-05-04 20:37:26 -04:00
CLAUDE.md docs: clarify planning-workspace role + flesh README 2026-05-20 07:59:20 -04:00
main.py init commit to create the project 2026-05-04 20:37:26 -04:00
pyproject.toml init commit to create the project 2026-05-04 20:37:26 -04:00
README.md docs: clarify planning-workspace role + flesh README 2026-05-20 07:59:20 -04:00
uv.lock init commit to create the project 2026-05-04 20:37:26 -04:00
wiki-construct-context.md init commit to create the project 2026-05-04 20:37:26 -04:00
wiki-construct-project-plan.md init commit to create the project 2026-05-04 20:37:26 -04:00

README.md

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/. 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/
│   └── skill-wiki.md             # Bundle for the wiki-maintenance skill
│                                 # (SKILL.md + compile.md + lint.md +
│                                 # migration.md, copy-paste-ready)
└── 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/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.

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/ — 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/.

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.