KBase v0.2.1 — Deliverable modifiers and plan mode

[hayabusa-cloud]

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 (Add (RO), (+W), (SK) deliverable modifiers #6)
• Add (+W) write-allow deliverable modifiers — explicit permission to edit product code (Add (RO), (+W), (SK) deliverable modifiers #6)
• Add (SK) skill-first deliverable modifiers — explicitly search skills and rules before proceeding (Add (RO), (+W), (SK) deliverable modifiers #6)

Improvements

• Add plan-mode bias principle to ROOT (Add (RO), (+W), (SK) deliverable modifiers #6)
• Extend compaction recovery chain to include rules/INDEX.md and skills/INDEX.md (Add (RO), (+W), (SK) deliverable modifiers #6)

Documentation

• Update protocol summary tables in all 5 README translations (Add (RO), (+W), (SK) deliverable modifiers #6)

Compatibility

• Agent: Any AI coding agent that reads AGENTS.md
• Platform: Any

---

This discussion was created from the release KBase v0.2.1 — Deliverable modifiers and plan mode.