Skip to content

docs(wiki): full wiki rebuild — 143 articles#12

Open
prakashUXtech wants to merge 1 commit into
mainfrom
docs/wiki-full-rebuild-2026-04-24
Open

docs(wiki): full wiki rebuild — 143 articles#12
prakashUXtech wants to merge 1 commit into
mainfrom
docs/wiki-full-rebuild-2026-04-24

Conversation

@prakashUXtech
Copy link
Copy Markdown
Contributor

What

First complete wiki for kb-go — 143 articles, one per source file under docs/wiki/, with 1,177 indexed concepts across 96 categories. Each article has JSON frontmatter (title, summary, concepts, categories) and a synthesized markdown body.

Why

Bring the repo's living wiki up to date against current code, and lay the baseline for an incremental refresh loop. No wiki existed before this pass.

How

  • kb prepare emitted compilation prompts per file
  • Five parallel Sonnet sub-agents compiled them (no API spend — ran on plan quota)
  • kb accept stored the result; wiki-sync.sh rsynced into this repo

What's in the PR

  • docs/wiki/*.md — 143 compiled articles (auto-generated, do not hand-edit)
  • docs/wiki/README.md — guardrail explaining the flow and how to fix an article (kb recompile <id>)
  • docs/wiki/index.md + index.json — auto-generated table of contents (grouped by category, top concepts ranked)
  • docs/wiki/.last-indexed-sha — baseline sha for incremental rebuilds

Going forward

Fresh commits on main will be picked up by:

  • the Claude Code Stop hook (docs-sync-hook.sh) when the captain commits from a session
  • a weekly cron sweep (wiki-weekly.sh) as safety net

Both read .last-indexed-sha and only recompile files changed since. Full rebuilds stay manual via make wiki-kb-go.

First complete wiki pass for kb-go — 143 articles compiled from *.go source,
one article per file. Adds guardrail README, auto-generated index.md +
index.json table of contents, and a .last-indexed-sha baseline for future
incremental rebuilds.

Compiled via kb-go prepare + Sonnet sub-agents (no API spend). Future
updates will flow through docs/scripts/wiki-sync.sh at the workspace level.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant