kb-system

kb-system

> Reusable Knowledge Base system for Claude Code — batch creation from PRDs, lists, stack manifests, or auto-detection.

A distributable Claude Code plugin that gives any project a structured, Context7-validated Knowledge Base in one command.

Why

Agents without a structured KB drift, hallucinate, and repeat old mistakes. This plugin materializes a governed KB with:

• Atomic files — strict line limits (quick-reference ≤100, concept ≤150, pattern ≤200)
• Context7-validated content — confidence thresholds tied to ctx7 CLI docs quality
• Generic domains — not just technologies: also concepts, processes, and business areas
• Batch creation — extract candidates from PRDs, stack manifests, or project dependency files

Install

/plugin marketplace add https://github.com/93diegopereira/kb-system
/plugin install kb-system

Or install locally while developing:

/plugin marketplace add file:///home/diego/Projetos/kb-system
/plugin install kb-system

Quickstart (3 commands)

# 1. Bootstrap the KB infrastructure in your project
/init-kb

# 2. Create domains in batch — pick ONE source:
/create-kbs genai pydantic python                          # inline list
/create-kbs --from-prd docs/PRD.md --dry-run               # extract from PRD (preview)
/create-kbs --from-stack stack.yaml --yes --parallel 3     # structured manifest
/create-kbs --auto-detect                                  # scan project manifests

# 3. Audit the health of your KB
/create-kb --audit

Commands

| Command | Purpose | |---------|---------| | /init-kb | Bootstrap KB infrastructure into the current project | | /create-kb <domain> | Create a single KB domain (Context7-validated) | | /create-kbs ... | Create many KBs in batch (list, PRD, stack, auto-detect) | | /create-kb --audit | Score and validate all KB domains | | /upgrade-kb | Sync project infrastructure with newer plugin version |

Domain Categories

Domains are not only technologies. Four categories are supported:

| Category | Examples | |----------|----------| | technology | python, pydantic, langchain, redis | | concept | genai, architecture, event-sourcing | | process | harness-engineering, code-review, incident-response | | business | billing, authentication, checkout |

Documentation

• Architecture: docs/architecture.md
• Quickstart guide: docs/quickstart.md
• Contributing: CONTRIBUTING.md
• Adding domains: CONTRIBUTING-KB.md

License

MIT — see LICENSE.