Files
cp1-agents/individual-agents/ALZ-F01: Discovery Workflow Agent/docs/adr/README.md
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

40 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](0001.md) | Eight separate agents chained by the KAB workflow, with no orchestrator | Accepted | All |
| [0002](0002.md) | Workflow hand-offs replace the `alz-run` tools | Accepted | All |
| [0003](0003.md) | The MCP write tools are dropped; outputs go back in the reply | Proposed | DSC-03, 05, 06 |
| [0004](0004.md) | The scan executor runs once per run and returns one finding per entry | Proposed | DSC-02 |
| [0005](0005.md) | Inventory before CMDB reconciliation; the inventory gets CMDB records from `alz-inventory` | Proposed | DSC-03, 04 |
| [0006](0006.md) | The critic's verdict is gated by human approval, not by code | Proposed | DSC-08 |
| [0007](0007.md) | Agent names | Proposed | All |
| [0008](0008.md) | Models: executors on `gpt-5.6-sol`, the critic on `gpt-5.4` (2026-11-03) | Accepted | All |
| [0009](0009.md) | Deploy with kustomize; keys stay in Secrets | Accepted | — |
| [0010](0010.md) | Step outputs travel through the workflow; there is no shared store | Proposed | All |
| [0011](0011.md) | Uploaded files and project artifacts reach the planner and the inventory as text | Accepted | DSC-01, 03 |
| [0012](0012.md) | The Discovery report comes from code, and the approval gate moves to it | Accepted | report (new) |
| [0013](0013.md) | A `provider` input lets one workflow read the sample estate or a live cloud | Accepted | All |
| [0014](0014.md) | A Well-Architected review step in Discovery, judged in code | Accepted | DSC-10 (new), report |
| [0015](0015.md) | 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](0016.md) | The run context file carries an intent, in the solution-architecture scope spec's format | Proposed | DSC-01, DSC-10, package, F02 |
| [0017](0017.md) | A live run's scope is every resource under the scope root, planned and checked in code | Accepted | DSC-01, DSC-08 |
| [0018](0018.md) | 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](0019.md) | 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](0020.md) | One Discovery package for the Assessment workflow, with a manifest and a value scorecard, built in code | Accepted | package (new), F02 ASM-01 |
| [0021](0021.md) | 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](template.md) and take the next number.