feat: the solution architecture agent on the shared Execution engine

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>
This commit is contained in:
2026-10-21 19:49:28 +01:00
commit c84dbdea20
127 changed files with 14672 additions and 0 deletions

View File

@@ -0,0 +1,51 @@
---
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.