kodebrain 0.4.3

Living knowledge map for codebases — install agent instructions across AI platforms

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

Document	Purpose
Taxonomy	Finalized node types, edge types, status labels, confidence labels
Skills	Skill API contracts — inputs, outputs, guarantees
Agents	Agent role boundaries — responsibilities, allowed skills, forbidden actions
Workflows	Core workflow sequence diagrams
Open Decisions	Unresolved architectural decisions

Schemas

File	Purpose
schema/node.schema.json	JSON Schema for KnowledgeNode
schema/edge.schema.json	JSON Schema for KnowledgeEdge
schema/knowledge-base.schema.json	Top-level graph container schema

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