knowledge-base

name	knowledge-base
description	Provides guidance for creating, updating, and reviewing project knowledge files. Covers frontmatter schema, naming conventions, staleness detection via covers: field, and the review workflow. Not for retrieval or search (use QMD directly), architectural decisions (use ADRs), or agent instructions (use AGENTS.md).
version	0.3.1

Knowledge Base

Contents

• Critical Rules
• Verification
• Quick Reference
• Topics
• When to Create a Knowledge File
• The covers: Field
• Review Workflow

Conventions and workflows for managing project knowledge files -- structured domain knowledge that lives in docs/knowledge/ and persists across sessions.

Critical Rules

Always

• Include topics (min 1) and last_reviewed in frontmatter
• Use kebab-case filenames in docs/knowledge/
• Add covers: globs when the knowledge maps to specific code paths
• Run loaf kb validate before committing new knowledge files
• Mark files reviewed with loaf kb review after updating

Never

• Duplicate code documentation in knowledge files
• Use date prefixes on knowledge filenames (unlike sessions or ideas)
• Use overly broad covers: globs that trigger constant staleness alerts
• Skip the last_reviewed field -- it is required for the lifecycle to work