Introduction
KBase is a structured, self-organizing knowledge base for AI coding agents. It persists agent knowledge — rules, references, decisions, skills — across sessions, so agents start informed instead of cold. Every directory follows a consistent AGENTS.md + INDEX.md pattern, with a tiered authority model (ROOT > rules > refs > notes > external) and a communication protocol for human–agent interaction.
Usage
Point your AI coding agent's config to the KBase/ directory. The agent reads AGENTS.md on session start and self-maintains the knowledge base.
AGENTS.md → ROOT/AGENTS.md → ROOT/communication.md → ROOT/instructions.md → rules/INDEX.md → skills/INDEX.md → notes/INDEX.md
Highlights
- This release introduces deliverable modifiers — suffixes on
[ ... ]and[[ ... ]]that control how artifacts are delivered. Three modifier families: read-only(RO), write-allow(+W), and skill-first(SK). - A new Plan Mode subsection formalizes when agents should ask before proceeding with major edits.
What's Changed
Features
- Add
(RO)read-only deliverable modifiers — analysis/review only, no product code changes (#6) - Add
(+W)write-allow deliverable modifiers — explicit permission to edit product code (#6) - Add
(SK)skill-first deliverable modifiers — explicitly search skills and rules before proceeding (#6)
Improvements
- Add plan-mode bias principle to ROOT (#6)
- Extend compaction recovery chain to include
rules/INDEX.mdandskills/INDEX.md(#6)
Documentation
- Update protocol summary tables in all 5 README translations (#6)
Compatibility
- Agent: Any AI coding agent that reads
AGENTS.md - Platform: Any