Skip to content

adr-file-system-knowledge-repository

Decision

Institutionalise file-system-knowledge-repository as an authoritative global architectural pattern following Reference Architecture ratification.

Context

  • Source: governance-flow
  • Pattern: file-system-knowledge-repository
  • Promotion Recommendation: recommendation-file-system-knowledge-repository
  • Scope Classification: global
  • Scope Classification Artifact: pattern-scope-classification

The file-system-knowledge-repository pattern provides git-native architectural persistence enabling transparent reviewability, pull-request governance, and auditable history without external database dependencies.

Scope

Applicability: Enterprise-wide across continuous architecture steering repositories and runner executions.

Governs the persistence layout, workspace synchronization, and versioning substrate for architectural artifacts, decisions, and governance models.

Consequences

Governance

Enforces Git pull-request review workflows and auditable version history for all architectural policy and catalog state modifications.

Execution

Decouples runner and workflow operations from external database infrastructure, relying entirely on local file operations and Git versioning.

System Behaviour

Guarantees reproducible offline execution and inspectable knowledge persistence across distributed multi-project environments.

Evidence Summary

Promotion Evidence

Ratified Reference Architecture in ArchGov and proven production usage across LocalKnowledgeProvider and bootstrap modules.

Promotion Criteria

Satisfied governance maturity, strategic alignment, evidence quality, and ratified reference architecture criteria.

Governance Risks

Potential filesystem merge contention under concurrent multi-agent or parallel pipeline state delta commits.

Traceability

Pattern Proposal

file-system-knowledge-repository

Scope Classification

Artifact: pattern-scope-classification

Classification: global

Promotion Recommendation

recommendation-file-system-knowledge-repository

Promotion Decision

promotion-decision-file-system-knowledge-repository

Next Step

  • Submit ADR to Architecture Forum for formal institutionalisation
  • Generate global pattern record in knowledge/global/patterns/