Skip to content

adr-file-backed-blackboard-workspace

Decision

Institutionalise file-backed-blackboard-workspace as a global architectural pattern following Reference Architecture ratification and governance maturity validation.

Context

  • Source: governance-flow
  • Pattern: file-backed-blackboard-workspace
  • Promotion Recommendation: recommendation-file-backed-blackboard-workspace
  • Scope Classification: global
  • Scope Classification Artifact: pattern-scope-classification

Uses a standardised, version-controlled filesystem structure as a shared blackboard for agent memory, templates, and runtime context without requiring external databases.

Scope

Applicability: Applies across all CAS runner workflows, workspace bootstrap routines, and repository knowledge layers requiring shared state persistence.

Global scope applicability for file-backed workspace state management and knowledge storage.

Consequences

Governance

Architecture state transitions and blackboard updates are version-controlled with complete git auditability and pull request governance.

Execution

FlowRunner and agent steps execute deterministically by reading from and writing to local file-backed structures.

System Behaviour

Eliminates external database infrastructure dependencies, guaranteeing offline execution and reproducible CI/CD environments.

Evidence Summary

Promotion Evidence

Ratified Reference Architecture in ArchGov and verified implementation in workspace bootstrap and execution profiles.

Promotion Criteria

Satisfied governance maturity and ratified reference architecture criteria.

Governance Risks

No critical governance risks identified; filesystem concurrency contention is mitigated by sequential pipeline execution.

Traceability

Pattern Proposal

file-backed-blackboard-workspace

Scope Classification

Artifact: pattern-scope-classification

Classification: global

Promotion Recommendation

recommendation-file-backed-blackboard-workspace

Promotion Decision

promotion-decision-file-backed-blackboard-workspace

Next Step

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