KB Update
Use after development, research, design, maintenance, or review work that changes durable knowledge.
AgentKB keeps Markdown as the canonical storage format. Load the smallest sufficient context first, and make every write reviewable with Git diff.
Context Order
- Read the project
context-pack.md. - Read
_system/write-policy.mdand_system/promotion-policy.md. - Read
current-state.md,decisions.md, andopen-questions.md. - Read recent logs only as needed.
Do not read personal/ or archive/ unless the user explicitly authorizes it.
Procedure
- Append a concise task log entry.
- Update
current-state.mdif durable project state changed. - Update
decisions.mdonly for durable decisions. - Update
open-questions.mdwhen uncertainty remains. - Refresh
context-pack.mdonly when it is stale or missing important current context. - Move project-useful personal/work extracts into
projects/<project>/candidates/. - Put high-impact or uncertain edits in
proposed-changes/. - Write a routing receipt in
_agent/routing-receipts/when routing or promotion happened. - Review the Git diff before completion.
Safety
Do not delete notes, rewrite accepted ADRs, edit archived notes, or store secrets.