Architecture Workspace¶
Purpose¶
Define the system structure, trust boundaries, quality strategy, evidence flow, AI-control approach, and architecture decisions before detailed design.
This directory should contain the project’s actual working artifacts for this lifecycle area. The links below intentionally point to the Template Library and, where available, the completed LMU/COICP example. Create the real project files in this directory when the project is ready to populate them.
What belongs here¶
| Artifact | Project File Name | Template | Completed Example |
|---|---|---|---|
| Architecture Overview | architecture_overview.md |
Template | Completed example |
| System Context | system_context.md |
Template | Completed example |
| Component Model | component_model.md |
Template | Completed example |
| Data And Evidence Flow | data_and_evidence_flow.md |
Template | Completed example |
| Quality Attribute Strategy | quality_attribute_strategy.md |
Template | Completed example |
| Ai Control Architecture | ai_control_architecture.md |
Template | Completed example |
| Architecture Decision Records | architecture_decision_records.md |
Template | Completed example |
| Architecture Review | architecture_review.md |
Template | Completed example |
| Architecture Readiness Summary | architecture_readiness_summary.md |
Template | Completed example |
Start from templates¶
Architecture Overview
Open the reusable template for architecture_overview.md.
System Context
Open the reusable template for system_context.md.
Component Model
Open the reusable template for component_model.md.
Data And Evidence Flow
Open the reusable template for data_and_evidence_flow.md.
Quality Attribute Strategy
Open the reusable template for quality_attribute_strategy.md.
Ai Control Architecture
Open the reusable template for ai_control_architecture.md.
Architecture Decision Records
Open the reusable template for architecture_decision_records.md.
Architecture Review
Open the reusable template for architecture_review.md.
Architecture Readiness Summary
Open the reusable template for architecture_readiness_summary.md.
Working pattern¶
- Open the relevant template.
- Create the same-named file in
docs/project-workspace/architecture/. - Replace template guidance with project-specific evidence.
- Compare the result with the LMU/COICP example when available.
- Record open risks, assumptions, and unresolved questions.
- Finish with the review or readiness artifact for this stage.
Evidence quality bar¶
| Quality | What It Means |
|---|---|
| Specific | Names actual project facts, stakeholders, systems, scenarios, risks, and decisions. |
| Traceable | Connects back to earlier stages and forward to later stages. |
| Reviewable | Gives another reviewer enough evidence to challenge or approve the work. |
| Current | Reflects the project’s actual state rather than old intent. |
| Governable | Makes AI use, exceptions, risks, release posture, and limitations visible. |
Create project artifacts here. Learn the artifact structure from the Template Library. Learn the completed pattern from the LMU/COICP example.