The reference agent's subject, cloud solution architecture, as an agent in the operating model agent's pattern: the Execution engine (from orchestration_engine) and one Workflow in app/solution_architecture, built for the settings and provider bundle by assembly.workflow_for. Copied from gcp_solution_architecture_agent at 8b397cd without its own engine: its role files, Skills, provider bundle, ADRs, vocabulary, scripts and evaluation datasets. The image takes the engine from a named build context and installs Terraform. It is called through the Orchestration engine, and its files are what the operating model agent digests. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
---
|
|
name: example-organisation-standards
|
|
description: >-
|
|
An example of an organisation's cloud standards as an overlay Skill: naming,
|
|
mandatory labels, approved regions and a short list of things never to do.
|
|
Use on any Deliverable of an Execution that names this overlay, to apply the
|
|
organisation's standards on top of the Cloud provider's guidance.
|
|
metadata:
|
|
scope: every Deliverable
|
|
overlay: organisation standards (example)
|
|
---
|
|
|
|
# Organisation standards (example)
|
|
|
|
This is an example. Copy it, replace every rule with your organisation's own, and name the copy when you start an Execution. Nothing here is a real organisation's policy.
|
|
|
|
An overlay adds to the Cloud provider's guidance. Where the two disagree, this Skill wins; where a requirement the user stated disagrees with this Skill, say so in your Deliverable and follow the user's requirement.
|
|
|
|
## Naming
|
|
|
|
- Every resource is named `<workload>-<environment>-<purpose>`, lower case, with hyphens: `orders-prod-ingest`.
|
|
- `<environment>` is one of `dev`, `test`, `prod`, and comes from a variable.
|
|
|
|
## Labels
|
|
|
|
Every resource that accepts labels carries all four:
|
|
|
|
| Label | Value |
|
|
| --- | --- |
|
|
| `workload` | the workload's short name |
|
|
| `environment` | `dev`, `test` or `prod` |
|
|
| `owner` | the owning team's short name |
|
|
| `cost-centre` | the cost centre code, from a variable |
|
|
|
|
## Regions
|
|
|
|
- Deploy only to `europe-west1` or `europe-west4`.
|
|
- Data at rest stays in the European Union.
|
|
|
|
## Never
|
|
|
|
- No public IP address on a database.
|
|
- No service account key files; workloads use attached identities.
|
|
- No resource without deletion protection in `prod`, where the resource type has it.
|
|
|
|
## What each Specialist does with this
|
|
|
|
- **Requirements:** record each standard above that applies as a non-functional requirement, with this Skill as its source, so it is traced like any other.
|
|
- **Design recommendations and Target architecture:** a standard that applies becomes a Check on every Element it constrains.
|
|
- **Infrastructure code:** follow the naming and label rules exactly.
|
|
- **Validation:** the standards are verified through the Checks that came from them.
|