Pattern Proposal: File-System Structured Knowledge Repository

Summary

Employs an organized directory hierarchy of markdown, YAML, and JSON files as the persistent source of truth.

Candidate Pattern

• ID: file-system-knowledge-repository
• Classification: architectural
• Maturity: established
• Type: implemented

Observed Signals

No specific signals listed.

Evidence

Supporting Evidence

• cas-knowledge/ - Directory structure containing global, projects, runtime, and templates sub-trees.
• src/cas_runner/bootstrap.py (init_workspace, merge_cas_governance_block) - Provisions workspace directories and synchronizes governance files into target projects.

Scope Assessment

• Evidence Strength: high
• Confidence: high
• Applies to: ideas-to-life-cas

Rationale

• Intent: Persist architecture decisions, rules, patterns, and runtimes directly in version-controlled directory structures.
• Context: Architecture knowledge must be transparent, reviewable via Git Pull Requests, and easily inspectable by human architects and scripts.
• Force: Databases add operational complexity and obscure Git-centric change tracking
• Force: Hierarchical knowledge requires clear categorization (global, project-specific, runtime, templates)

Traceability

Artifact source: proposed-patterns