kb-framework-template

AI-native Knowledge Base Framework — a reusable template repository for building structured, version-aware, confidence-tagged knowledge bases that are consumed by AI agents.

Owner: René Sebastian Kaup (LinkedIn) Status: ✅ v1.0 functionally complete + Iteration 2 hardening. Architecture, governance, the interactive /kb-setup agent, the /import pipeline, the consistency gate, and the optional skills pipeline are all in place. Iteration 2 added a note scaffolder (/new-note), two more note types (troubleshooting, decision-record), five deeper structural gate checks, a self-test harness with CI, a committed sample instance (_examples/claude-code-kb), and a generic discovery-tools slot. Iteration 3 added a generalized self-audit framework (/kb-audit, Supervisor + two independent tracks, 6-dimension maturity model) and a generic human onboarding template (01-meta/ONBOARDING.md).

Verify it yourself

Fastest -- run the framework self-test (instantiates throwaway copies, asserts the gate passes on clean KBs and fails on injected drift):

pwsh ./tools/Test-Framework.ps1     # expect: RESULT: PASS -- 12/12 cases met expectation

Or instantiate into a throwaway copy and run the gate by hand:

1. Copy the repo (excluding .git) to a scratch folder.
2. Run /kb-setup (or call tools/Initialize-KB.ps1 with a kb-setup.config.json).
3. Run tools/Check-KBConsistency.ps1 -- it should report RESULT: PASS -- 0 blocking problems.

Or just gate the committed sample: tools/Check-KBConsistency.ps1 -RepoRoot ./_examples/claude-code-kb.

---

What this repository is

This repo is a domain-agnostic template. After running an interactive AI setup agent (/kb-setup), it can be adapted to any knowledge domain (e.g. a software platform, a product, a regulatory area) and then used to collect knowledge for AI agents.

It generalizes a mature, production-proven knowledge base into reusable framework machinery:

• Three-layer progressive-disclosure architecture — L0 routing → L1 domain MOCs → L2 atomic notes → L3 references
• Governance system — rules for adding/extending knowledge, a new-vs-extend decision tree, a glossary, an import pipeline
• Confidence tagging — every claim is source- and trust-tagged
• Front-matter contract — mandatory metadata on every artifact, mechanically gated
• Six note types — concept, how-to, reference, q-and-a, troubleshooting, decision-record (ADR)
• Note scaffolder — /new-note (tools/New-Note.ps1) writes correct front-matter + a MOC routing row for you
• Sprint methodology — board/ledger/decisions, lessons-learned, lifecycle checklist
• Claude Code integration — CLAUDE.md, slash-commands, skill-build pipeline
• Quality gates — consistency checker (16 checks: front-matter, links, counters, duplicate ids, MOC paths, orphans, staleness, sprint-dossier completeness, human-review visibility, skill coverage, ...), commit-message hygiene, CI workflows
• Self-test harness — tools/Test-Framework.ps1 proves the toolchain on every push (CI)
• Sample instance — _examples/claude-code-kb shows a real, gate-green KB with all six note types
• Discovery slot — tools/discovery/ generic skeleton for source-acquisition feeding /import
• Human onboarding — 01-meta/ONBOARDING.md gentle end-to-end entry path for new colleagues (Git, gates, sprints, audits, sub-agent orchestration)
• Self-audit framework — 01-meta/governance/audits/ periodic maturity + quality review (/kb-audit: Supervisor + two independent tracks, 6-dimension CMMI model, read-only, evidence-based)

How it will be used (target flow)

1. Clone/use this template for a new knowledge domain.
2. Run the interactive setup agent (/kb-setup) — it interviews you (domain, sources, taxonomy) and fills in all placeholders.
3. Start collecting knowledge using the /import pipeline and the governance rules.
4. Optionally build Claude Skills from the corpus.

Editor tip: the KB is plain Markdown, so any editor works. Obsidian pairs well (optional, per-instance) — the template ships no .obsidian/ config; set one up yourself if you want it. See 01-meta/ONBOARDING.md J5.

License

This framework template is licensed under the MIT License — free to use, copy, modify, and distribute with attribution.

Scope note: the MIT license covers the reusable framework machinery in this repository only. Knowledge bases you create from this template are your own — their content and license are yours to choose (set {{LICENSE_KIND}} during /kb-setup and add a LICENSE to the instance).