- 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>
3.5 KiB
3.5 KiB
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.