KB Capture
Use when the user gives loose notes, ideas, work observations, project context, or reusable knowledge that should be preserved and routed.
AgentKB keeps Markdown as the canonical storage format. Load the smallest sufficient context first, and make every write reviewable with Git diff.
Required Context
- Read
AGENTS.md. - Read
_system/kb-structure.md. - Read
_system/routing-rules.md. - Read
_system/metadata-schema.md. - Read
_system/write-policy.md. - Read
_system/promotion-policy.md. - Read project
context-pack.mdonly when the capture references a project.
Do not read personal/ or archive/ unless the user explicitly authorizes it in the current request.
Procedure
- Preserve the original input under
inbox/codex-captures/YYYY-MM-DD-HHmm-<slug>.md. - Classify the capture as personal, work, project, reusable knowledge, reference, or promotion candidate.
- Create or append the structured note in the target directory.
- Put project-useful extracts in
projects/<project>/candidates/when they need review before becoming project context. - Put team-shareable material in
promotion/candidates/before sanitization and review. - Write
_agent/routing-receipts/YYYY-MM-DD-HHmm-<slug>.mdwith source path, output path, classification, confidence, and review state. - Review the Git diff.
Output
- Raw capture
- Structured note or candidate
- Routing receipt
- Review marker when confidence is low