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

1.0 KiB

ADR 0012: the Discovery report comes from code, and the approval gate moves to it

Status: Proposed. Date: 2026-11-01.

Context

The workflow ended at the critic's verdict and produced no report for the Engagement Lead, who approved from the verdict alone.

Decision

Add cp1-discovery-report-agent as the last step. Its pre_process hook renders the report in code, as Markdown and as a self-contained HTML page, and replies without calling a model, so it can only repeat what the steps recorded. The approval gate moves from the critic to this step, so approval is given on the whole report. This updates ADR 0006.

A Format for UI step after the gate takes final_html, so an approved run ends with an artifact of the clean page. This is on trial.

Consequences

The report has no written narrative. The verdict still isn't enforced: a person can approve a fail, and the report marks one at the top. The saved workflow must be imported again, and a run that fails before the report step produces no report.