Files
Jonathan Boniface 9e503885cc ALZ-F01 Discovery: package step, value scorecard, application grouping, cases
- 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>
2026-11-05 22:13:25 +00:00

3.5 KiB
Raw Permalink Blame History

Architecture decision records: individual agents, ALZ-F01 Discovery

Each record documents a change to the original requirements for ALZ-F01 Discovery: the ADO Feature 3214441, its stories 3214451–3214458, and the v1.1 story files (drafts/cp1/agentic-landing-zone/stories/F01-discovery/ in the engineering hub workspace). These records apply to the individual-agents pattern in this Feature folder. The sub-agent pattern in sub-agents/ALZ-F01: Discovery Workflow Agent/ keeps its own records, and the two patterns' decisions are separate. Which pattern is adopted has not been decided.

Each agent's docs/adr/README.md lists the records that change its own story.

Status values:

  • Accepted: decided by the product owner.
  • Proposed: built as a default and awaiting confirmation.
ADR Decision Status Stories
0001 Eight separate agents chained by the KAB workflow, with no orchestrator Accepted All
0002 Workflow hand-offs replace the alz-run tools Accepted All
0003 The MCP write tools are dropped; outputs go back in the reply Proposed DSC-03, 05, 06
0004 The scan executor runs once per run and returns one finding per entry Proposed DSC-02
0005 Inventory before CMDB reconciliation; the inventory gets CMDB records from alz-inventory Proposed DSC-03, 04
0006 The critic's verdict is gated by human approval, not by code Proposed DSC-08
0007 Agent names Proposed All
0008 Models: executors on gpt-5.6-sol, the critic on gpt-5.4 (2026-11-03) Accepted All
0009 Deploy with kustomize; keys stay in Secrets Accepted —
0010 Step outputs travel through the workflow; there is no shared store Proposed All
0011 Uploaded files and project artifacts reach the planner and the inventory as text Accepted DSC-01, 03
0012 The Discovery report comes from code, and the approval gate moves to it Accepted report (new)
0013 A provider input lets one workflow read the sample estate or a live cloud Accepted All
0014 A Well-Architected review step in Discovery, judged in code Accepted DSC-10 (new), report
0015 A live run's inventory is built in batches, at most three tries per batch; a batch that fails all three fails the step Accepted DSC-03
0016 The run context file carries an intent, in the solution-architecture scope spec's format Proposed DSC-01, DSC-10, package, F02
0017 A live run's scope is every resource under the scope root, planned and checked in code Accepted DSC-01, DSC-08
0018 Uploaded CMDB exports are normalised by the model to our CI schema, and judged and reconciled in code Accepted DSC-01, DSC-03, DSC-04, DSC-08, report
0019 A live run's dependency graph is built in code: one graph of resource, external and CMDB CI nodes Accepted DSC-04, DSC-06, DSC-08, report
0020 One Discovery package for the Assessment workflow, with a manifest and a value scorecard, built in code Accepted package (new), F02 ASM-01
0021 A live run's applications and asset owners are grouped in code: CMDB, then tag, then container, then a judged model proposal Accepted DSC-03, DSC-04, DSC-06, report, package, F02 ASM-01

New records copy template.md and take the next number.