Files
channel-architecture-skic/references/aerosim-lessons-review.md
T
jarvis-at-skic 3b682a44dc
Validate skill / validate (pull_request) Successful in 5s
Validate skill / validate (push) Successful in 6s
docs: reconcile canonical SKIC channel skill names
2026-10-21 17:56:54 +00:00

49 lines
7.4 KiB
Markdown

# AeroSim lessons review — Architecture
## Sources and scope
- Complete pinned [Architecture package](https://gitea.lego-cloud.eu/corp-v1-aerosim-skills-code-agent/channel-architecture-skic-aerosim/src/commit/d7900acfa923d8c7bb32f6e8e269048f5d4b8d4f/SKILL.md), immutable SHA `d7900acfa923d8c7bb32f6e8e269048f5d4b8d4f`: **Epic and Feature Transition**, **Capability-safe partial remediation**, **Current-gate freshness audit**, **Human requirement intake before solution approval**, **Architecture Structure Synchronization Audit**, all eight references, adoption record, tests and validation workflow.
- Supplemental read-only `/opt/data/skills/productivity/channel-architecture-skic-aerosim/SKILL.md`, SHA-256 `ecf45551eba3106cc4e94414bb9cad9a24974dbe253417b83252662fabbb05e8`: **Scope ↔ Architecture board alignment**, **Architecture Board Acceptance and Definition of Done**, **Architecture system of record**, **Release 2 Jira output delivery override**. Runtime-only additions are not attributed to the pinned remote SHA. They supply evidence-management lessons, not permission to adopt the project's tools or authority.
- Central baseline `a599b11944fcfdb7343de914b1d53763ddc24e40` (1.9.0). Board owner review request `1562171939961966693` authorizes central reference review and remote publication, followed by verified central runtime refresh; it does not authorize project rollout or authority changes.
## Reusable operating additions
### Intake and no-churn maintenance
A human requirement statement is intake, not automatically solution approval. Preserve exact wording, actor, date and message; distinguish a cross-cutting constraint from a Feature outcome and route canonical identity/parentage to Scope. Before solution approval, maintain only the existing gate or assessment artifact: do not assign FR/NFR IDs, derive ADRs/interfaces/Tasks or allocate versions. After Scope publishes canonical records, retire the obsolete canonicalization blocker and name the remaining exact approval gate. Preserve intake history.
Treat dated provenance as an evidence-window snapshot, not a cursor that must follow every bot message. Reuse the owning artifact/PR. Apply the existing [convergence procedure](scheduled-sync-evidence-convergence.md); edit only for material decisions, relevant path/shared-data changes or false current-state claims. An already accurate durable waiting gate plus verified unchanged state satisfies maintenance; it does not authorize solution work. Safe non-semantic repair remains possible without inventing approval.
### Scope-to-board coverage and output acceptance
Where a project already uses an Architecture board, reconcile its work references against canonical Scope items at handoff: exact canonical IDs, source links, purpose, dependencies and supersessions. Reuse one reference per item and purpose; do not duplicate implementation Tasks or claim alignment from counts alone. Coordinate with the existing writer and read back the result. This does not create a board, recurring job or Focus admission.
Keep input readiness, execution, release membership and output acceptance separate using the existing [lifecycle dimensions](multidimensional-lifecycle-presentation-audit.md). Input checks record pass/fail/not-applicable with rationale, evidence and a missing-input owner. Completion requires applicable reviewable outputs and reciprocal traceability, exact revision validation/review, resolved conditions or an authorized exception, and exact-item acceptance evidence under the project's existing approval contract. Historical Done, a link-only comment or a readiness assessment is not accepted substantive output; material output changes require renewed acceptance without erasing history. If native filters cannot represent these independent dimensions, report the capability gap and retain a durable assessment rather than claiming title prefixes implement filters.
### Destination and capability boundaries
Resolve the active authorized system of record, release scope and output revision before editing. A project-local destination change must explicitly identify superseded guidance and the legacy/derived artifacts to which it still applies. Preserve canonical business IDs, source revisions and reciprocal links; keep server-native object IDs isolated when the platform resolves them globally. Pull current destination content before writing and read back substantive saved output, not merely the existence of links. Local generation is not server publication. A storage decision does not authorize implementation or change human decision ownership.
C4/Draw.io/Docusaurus remain the central default; no Jira-only or CogArch-only policy is introduced here. Use project-approved tools and their governing skills. When a required capability is unavailable, narrow work to a coherent artifact without leaving prose and diagrams contradictory; identify the coordinated deferred change and report partial completion. The existing [C4 source/runtime reconciliation](c4-container-registry-component-views.md) owns the detailed two-baseline procedure; do not duplicate it here.
## Improvements and contradiction resolution
- Replaced forced `In Solution` transition with the canonical schema's solution state; approval history is unchanged.
- Reconciled proactive iteration with the source's no-churn rule and linked this reference from SKILL.
- Removed stale fixed channel counts in inherited references; the existing approved information boundary still controls access.
- Aligned the C4 reference navigation example with the central exact-label contract, without migrating any project names or navigation.
- Made delegated solution-package examples explicitly conditional on existing authorization; they cannot silently override central human gates.
- Reused existing C4, lifecycle, convergence, handoff and review references rather than copying their full rules. Updated the existing test's version assertion only; its approval and readiness mutation tests remain intact.
## Excluded project decisions and source issues
Excluded named owners, standing merge delegations, board/channel IDs, dispatch scripts and webhook transport, CogArch architecture IDs/native view strategy, the Release 2 Jira exception and its AERS issue policy, AeroSim naming and seven/eight-channel migrations. These are project decisions, not portable central defaults. Runtime and pinned package differ substantially; runtime still mixes historical scheduled/eight-channel prose with newer seven-channel wording. Do not infer access expansion or scheduler authorization from these historical references. The source's destination overrides are evidence of scoped precedence, not an invitation to migrate central C4 or Docusaurus.
## Existing topology reconciliation
The review also restores the existing Board-approved eight-channel topology, including UAT, in descriptions, boundary lists and handoff paths. This is consistency repair, not new channel authority; no historical bootstrap override is widened.
## Verification
Run `python3 -B -m unittest discover -s tests -v` and `git diff --check`. Tests cover package links, portable contracts, absence of stale channel counts and retained human gates alongside the existing negative readiness/decomposition tests. They do not prove a live board, architecture service, diagram or deployment was validated. No AeroSim or other project-adopted package is modified; central runtime packages are refreshed only after verified source publication.