KBase v0.1.1 — Persistent Knowledge Base for AI Coding Agents

[hayabusa-cloud]

KBase

Structured, self-organizing knowledge base that persists agent knowledge across sessions.

What is KBase

KBase stores rules, references, decisions, and skills so AI coding agents start informed instead of cold. Knowledge accumulates across sessions — agents read AGENTS.md on start and self-maintain the base.

Structure

Directory	Role
ROOT/	Meta-principles, bootstrap, commands
rules/	Constraints and conventions
refs/	Verified external knowledge
notes/	Project insights and decisions
skills/	Automation workflows
plans/	Auto-generated task plans
env/	Environment configurations
hooks/	Event-driven callbacks
perms/	Secrets and credentials (gitignored)

What's New in v0.1.1

Review-Fix Notation

Two new notation forms for the communication protocol:

Notation	Meaning
[ X ] : ( Y )	Soft — Review scope X against expectation Y; fix if unsatisfied. Best effort.
[[ X ]] : (( Y ))	Hard — Deep review X against Y. Must satisfy; violation = blocked.

The soft form composes existing [ ] (optional deliverable) with ( ) (prefer constraint). The hard form composes [[ ]] (must deliverable) with (( )) (must constraint), requiring thorough review and strict satisfaction.

Features

• Active persistence — agents save findings immediately without being asked
• Tiered authority — ROOT/ > rules/ > refs/ > notes/ > external; higher tier overrides lower
• Communication protocol — structured notation for human–agent interaction
• Lifecycle transitions — notes promote to refs (verified) or rules (recurring constraint)
• Agent-agnostic — works with any AI coding agent that supports AGENTS.md
• Built-in commands — research, review, tidy, recall, save, promote

Quick Start

1. Clone: git clone https://github.com/hayabusa-cloud/KBase.git
2. Point your AI coding agent's config to the KBase/ directory.
3. Work. The agent reads AGENTS.md on session start and self-maintains the knowledge base.

MIT License — ©2026 Hayabusa Cloud Co., Ltd.

---

This discussion was created from the release KBase v0.1.1 — Persistent Knowledge Base for AI Coding Agents.