Architecture Principles, Standards, Policies & Decisions Profile
Overview
Governance framework for documenting and enforcing architectural principles, standards, and policies, and for capturing architectural decision records (ADRs).
Model elements
| Id | Name | Description |
|---|---|---|
a1.principle | Architecture Principle | A fundamental rule or guideline that guides architectural decisions |
a1.standard | Architecture Standard | A specific technical standard or specification that must be followed |
a1.policy | Architecture Policy | A mandatory rule or requirement that must be enforced |
a1.architectural-decision-record | Architectural Decision Record | A record of an architectural decision that was made |
Relationships
| Id | Name | Description |
|---|---|---|
a1.implements | implements | Indicates that a standard or policy implements a principle |
a1.enforces | enforces | Indicates that a policy enforces a standard |
a1.applies-to | applies to | Indicates that a principle, standard, or policy applies to an element |
a1.related-to | related to | Indicates a general relationship between principles, standards, or policies |
a1.conflicts-with | conflicts with | Indicates that principles, standards, or policies conflict with each other |
a1.supersedes | supersedes | Indicates that an ADR supersedes another ADR |
Usage
- Define Principles: Create Architecture Principle elements for fundamental rules
- Create Standards: Define Architecture Standards that implement principles
- Establish Policies: Create Architecture Policies for mandatory requirements
- Record Decisions: Create Architectural Decision Record elements for significant choices
- Link Relationships: Use "implements" and "enforces" to show how they relate
- Apply to Elements: Use "applies-to" to link governance to specific elements
- Track Compliance: Update compliance status on "applies-to" relationships
- Document Conflicts: Use "conflicts-with" to document trade-offs
- Supersede ADRs: Use "supersedes" when a newer decision replaces an older one
Reference
For the complete OML profile definition, see the a1-principles-standards-profile-1.0.3.yaml file.