Skip to content

KBase v0.2.1 — Deliverable modifiers and plan mode

Latest

Choose a tag to compare

@hayabusa-cloud hayabusa-cloud released this 24 Feb 06:22
72a084c

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.md and skills/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