- New cp1-discovery-package-agent (ADR 0020): one package per reviewed run, every part hashed (sha256 over canonical JSON), with a manifest and a value scorecard. - Applications grouped CMDB -> tag -> resource group with a judged model fallback (ADR 0021): CMDB 0.7.0 carries ownership, dependency mapping 0.6.0 groups, report 0.9.0 shows them. - Critic 0.6.1 accepts the producers' enums; build_workflow.py refuses a consumer enum narrower than its producer's. - Code hooks, sub-agents and tests for the inventory, CMDB, dependency, planner and critic agents; the report and Well-Architected review agents; ADRs 0012-0021. - Workflow cases with value bars and run limits; run evaluation and usage collection scripts; the run context template and the field-by-field review for ADR 0016. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.9 KiB
4.9 KiB
0021. A live run's applications and asset owners are grouped in code: CMDB, then tag, then container, then a judged model proposal
| Status | Accepted |
| Date | 2026-11-05 |
| Decided by | Product owner, 2026-11-05: "CMDB→tag→RG, review model" (code groups by CMDB business service, then the application tag, then resource group; the model proposes groups only for what's left, code judges them, and model-proposed groups are flagged for the Engagement Lead's review). Plan: ../discovery-value-plan.md, phase 3 |
| Requirements changed | ALZ-DSC-03 and ALZ-F02 ASM-01 ("inventory (applications and assets)"): a live run lists applications, from the dependency step rather than the inventory. ALZ-DSC-04: each CI's result carries its owner, business service and support group. ALZ-DSC-06: the dependency step groups applications and names owners |
Context
- F02 needs applications. Its planner groups by the Discovery
applicationslist, else byfacts.business_service, and live runs had neither, so every asset was a gap (review of 2026-11-04, item 5). The value scorecard's baseline (ADR 0020) showed application and owner missing on all 10 records of the CMDB case. - The evidence was there but never reached Assessment. The uploaded CMDB names each CI's
owned_byandbusiness_service, but the CMDB step's per-CI results dropped them. Every resource carries anApplicationtag. - The dependency step is the right place: it runs after the CMDB step, already joins records to CIs (ADR 0019), and is answered in code.
Decision
- The CMDB step's
ciscarry each CI'sowner,business_serviceandsupport_group, verbatim (0.7.0). - The dependency step groups each record, once, in this order (
app/applications.py, 0.6.0):- the matched CI's business service (
basis: cmdb_business_service); - the resource's application tag (
Application,app,application_name,app_name,business_service,service, any case;basis: tag). Tag alias: when every CMDB-grouped member of one application carries the same application tag, a tag-only record with that tag joins that application, flagged for review. A tag two applications claim is no alias; - its resource group or project (
basis: container), flagged for review; - for what's left only, the
propose_application_groupssub-agent, from names, types and environments. Code rejects the whole reply if any group names an asset not asked about, places an asset twice, or has an empty, over-long or instruction-like name. Every model group is flagged for review; a rejected or failed reply leaves its assets ungrouped, which the note says.
- the matched CI's business service (
- Owners: from the matched CI (
owner, elsesupport_group), else an owner tag. An application's owner is set only when its members' owners agree (owners_disagreeotherwise). No owner is inferred. - Outputs:
applications(id, name, basis, members, owner, business service, evidence,review_requiredand reasons),asset_owners,ungrouped_assetsandapplications_note. The report shows them after the inventory and lists the groups to review (0.9.0); the package carries them as itsapplicationspart, and the scorecard reads a record's application and owner from it (package 0.2.0, scorecard version 2).
Consequences
- Expected on the CMDB case: one application, "KAB Platform", of 10 assets: 8 by the CMDB, 2 (the DNS zone and
the Event Grid topic, which have no CI) by the
Application: AppName1tag every CMDB-grouped member shares, flagged for review. Owner "Platform Engineering" for the 8 matched assets; the 2 orphans have none, correctly. Scorecard: F02 fields filled from 24% to about 46%; run checks 7 of 7; findings with an owner from 0% to about 33% (the stale attributes on owned assets; orphans and ghosts have none). - Without a CMDB: one application, "AppName1", by tag, needing no review, and no owners: the CMDB gap declares them.
- The model is rarely asked: on Azure and Google Cloud every resource has a resource group or project, so step 4 runs only for estates with no container. Its tests use a stand-in model.
- Applications are not graph nodes. They're a separate list, so no edge or node enum changed and no other step's input schema had to. Membership edges can be added later if a consumer needs them in the graph.
- The review is the Engagement Lead's, at the report's review point. Assessment reads
review_requiredand can decide how to treat a group the lead didn't change. - Live, 2026-11-05:
exec_58ba6a71d00b(azure-crucible-kab-dev-cmdb) passed 56 of 56 checks: one application, KAB Platform, of 10 assets, flagged for review; 8 owners; 46% of F02's fields filled; 7 of 7 run checks.exec_925194d79c47(azure-crucible-kab-dev) passed 21 of 21: AppName1 by tag, no owners, 37% filled. Neither run asked the grouping model.