Files
gcp_solution_architecture_a…/skills/google-cloud-lessons/references/target_architecture.md
Jonathan Boniface e5e1647ff1
Some checks failed
validation / verify (push) Failing after 13s
feat: prove the lessons, check overlays in evaluation, and settle the cost steps
- Schema review: a dotted path is judged only when it starts at a name the
  resource type has, so a database flag or a service name is no longer read
  as a missing setting. Lesson L-04, which worked around that, is retired.
- Skill routing: in a Change request the question says what changed.
- Evaluation: a case may list code_standards the infrastructure code must
  meet; case 06 checks its overlay's regions, naming and labels.
- Model tiers (iteration 5 step 6): a lighter model for a role's first
  attempt, named in the provider bundle. Measured on case 03 and left off:
  Flash saved five cents on the IaC author and took twice the requests.
- Steps 7 and 9 decided against on the numbers, recorded in the plans.
- Plans: the runs of cases 05 and 06, and the first proof of the lessons on
  case 03 (no Revision, 22 minutes against 28, quality held).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 21:27:09 +01:00

1.6 KiB

Lessons: target architecture

Rules learned from earlier work. Follow every one that applies.

L-01: Create Specific Checks for All Constraints

Rule. Create specific Checks for every explicit constraint, metric, or capability mentioned in a requirement, rather than relying on a single broad Check.

Why. If detailed constraints are missed, the validation phase will reject the design for incomplete coverage, forcing a revision.

Published 2026-10-09, from lesson proposal 01.

L-02: Assign Checks to Every Element

Rule. Give every Element at least one Check before you submit.

Why. The submission tool will reject the architecture if any Element lacks a Check, wasting an attempt.

Published 2026-10-09, from lesson proposal 02.

L-03: Verify Resource Arguments for Checks

Rule. Verify that the specific resource type used for an Element actually supports the configuration argument you specify in a Check. Remember that access policies and certain configurations often require entirely separate resources.

Why. If a Check specifies an argument that does not exist on the resource, it cannot be implemented, forcing an architectural revision.

Published 2026-10-09, from lesson proposal 03.

L-06: Do Not Mark Requirements as Not Applicable

Rule. Do not list Requirements in the not applicable field, as this field is strictly for Design Recommendations. Ensure every Requirement has at least one Check.

Why. The submission tool will reject the deliverable if a Requirement lacks a Check or is incorrectly marked as not applicable.

Published 2026-10-09, from lesson proposal 06.