kb-builder

Kode Brain — a living knowledge system for evolving software projects.

Converts an imperfect, growing codebase into a structured, searchable knowledge map of domains, capabilities, concepts, flows, runtime behavior, dependencies, legacy areas, migration states, and source evidence — so humans and AI agents can understand and modify the system without rediscovering everything from scratch.

Design Documents

Schemas

Design Order

Per the Kode Brain spec (§20.7):

Taxonomy → Workflow → Skills → Agents → Plugin/CLI

This repository is currently at the design phase. Implementation comes after the design is validated.

Commands

/kodebrain init [path]                     Scan project, scaffold docs/kodebrain/
/kodebrain scan [path]                     Re-scan and update knowledge graph
/kodebrain query "<task or symptom>"       Query the KB by task description
/kodebrain reading-pack "<task>"           Generate + save a context pack
/kodebrain detect-legacy [--domain slug]   Flag suspected dead code
/kodebrain review [--page path]            Review KB pages for stale claims
/kodebrain update [--diff] [--files ...]   Update KB from changed files

Installation

pip install kodebrain
kodebrain install        # installs skill + platform configs globally

/kodebrain is then available in every Claude Code session.

Developing the skill

The skill definition lives in kodebrain/skill/ — SKILL.md and scripts/harvest.py. To have changes take effect immediately without reinstalling:

# Symlink the skill dir directly (dev mode)
ln -s "$(pwd)/kodebrain/skill" ~/.claude/skills/kodebrain

Or install the package in editable mode so kodebrain install always picks up local changes:

pip install -e .
kodebrain install