Files
gcp_solution_architecture_a…/skills/google-cloud-lessons/references/target_architecture.md
Jonathan Boniface a7bc5310f3 feat: the lessons loop, and six lessons approved and published
Capture, distil, review, publish, retire (ADR-0004). Lesson candidates of
past Executions are grouped into what recurred; a lesson-curator role,
outside any Execution, proposes a lesson per group worth one; each proposal
is an issue file a person approves or rejects; an approved lesson is
written into the provider's lessons Skill, which a Specialist is given only
once it holds lessons for that Specialist's Deliverable. LESSONS_ENABLED
off runs without them, for an evaluation with and without.

The curator proposed six lessons from 21 Executions. The owner approved all
six on 2026-10-09 and they are published: five for the target architect,
one for the IaC author. None is proved by an evaluation yet.

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

2.0 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-04: Avoid Using Values as Setting Names

Rule. When writing a Check for a configuration block that takes a name and value, explicitly state the block's argument name instead of writing the expected value as if it were the setting itself.

Why. Automated reviews may mistake specific expected values for invalid setting names, causing warnings and submission delays.

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

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.