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>
This commit is contained in:
@@ -0,0 +1,99 @@
|
||||
# Run context: field-by-field review for ADR 0016
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| Date | 2026-11-05 |
|
||||
| For | The product owner, going through [ADR 0016](adr/0016.md) (Proposed) field by field before value plan phase 2 |
|
||||
| Source | The scope spec catalogue the ADR borrows (`outcome-pattern/solution_architecture/.../skills/scoping/assets/catalogue.yaml`), 51 fields |
|
||||
| Status | Recommendations only. Nothing is built from this until the decisions column is filled in |
|
||||
|
||||
## How to read it
|
||||
|
||||
- **Boundary (decided 2026-11-05):** Discovery's output feeds only Assessment (F02). The solution architecture stream
|
||||
is separate, so nothing here is a hand-over to it, and F01 would keep its **own** copy of whatever fields it adopts,
|
||||
with its own catalogue. ADR 0016's points 1 and 5 (one file through to solution architecture; a shared catalogue)
|
||||
would be dropped.
|
||||
- **Who settles it:**
|
||||
- **Evidence:** Discovery can read the current value from the cloud or the CMDB, and records it with its
|
||||
provenance. The customer may still state a target; Discovery then reports current against stated.
|
||||
- **Customer:** only the customer can say it. Discovery reads it and uses it; it can be `ask`, `decide` or
|
||||
`not_applicable`.
|
||||
- **Not Discovery:** a design or delivery choice. It belongs to a later workflow, not to this file.
|
||||
- **Used by:** the step or consumer that would act on it today or in a planned phase.
|
||||
- **Recommendation:** **Keep** (adopt now), **Later** (worth having, no consumer yet), **Drop** (not Discovery's, or
|
||||
already covered).
|
||||
|
||||
Discovery's own sections stay as they are: `workflow_inputs`, `generated`, `uploads`, `customer`, `plan`, and
|
||||
`context` (`scope`, `sources`, `owners`, `business_services`, `assets`).
|
||||
|
||||
## Fields
|
||||
|
||||
| # | Field | What it is | Who settles it | Used by | Recommendation | Decision |
|
||||
|---|---|---|---|---|---|---|
|
||||
| 1 | `metadata.customer_case` | The engagement's short reference | Customer | All | **Drop**: `workflow_inputs.engagement_id` already is this | |
|
||||
| 2 | `engagement.kind` | Workload, platform foundation or migration | Customer | Planner (what's essential), F02 | **Keep** | |
|
||||
| 3 | `intent.statement` | What the customer wants, in their words | Customer | Report (shown as data) | **Keep**, as data only: never sent in a tool call, never passed to every step | |
|
||||
| 4 | `intent.requirements` | Stated requirements with ids (`REQ-01`) | Customer | Well-Architected review (cite the `REQ-` behind a gap), report | **Keep** | |
|
||||
| 5 | `intent.exclusions` | What's out of scope | Customer | Planner | **Drop**: `context.scope.exclude` already holds this for Discovery | |
|
||||
| 6 | `intent.success_criteria` | How the customer judges success | Customer | — | **Later** | |
|
||||
| 7 | `estate.cloud_provider` | The provider | Customer | — | **Drop**: `workflow_inputs.provider` is this | |
|
||||
| 8 | `estate.mode` | Greenfield, brownfield expansion or migration | Customer | Planner, F02 | **Keep** | |
|
||||
| 9 | `estate.regions.primary` | The main region | Evidence | Planner, report | **Keep**, settled from evidence; `context.scope.regions` stays the scan's filter | |
|
||||
| 10 | `estate.regions.secondary` | A second region | Evidence | Report | **Keep**, settled from evidence | |
|
||||
| 11 | `estate.regions.resiliency_tier` | Single region, warm standby or active-active | Evidence (current); customer (target) | Well-Architected reliability | **Later** | |
|
||||
| 12 | `estate.data_residency` | Where data must stay | Customer | F02 (compliance), Well-Architected | **Keep** | |
|
||||
| 13 | `estate.existing_systems` | What exists today | Evidence | — | **Drop** as a field: it is Discovery's whole output (inventory, applications) | |
|
||||
| 14 | `workload.users.who` | Who uses it | Customer | — | **Later** | |
|
||||
| 15 | `workload.users.count` | How many users | Customer | — | **Later** | |
|
||||
| 16 | `workload.users.peak_concurrent` | Peak concurrent users | Customer | — | **Later** | |
|
||||
| 17 | `workload.availability.target` | Availability, as a percentage | Customer | Well-Architected reliability, F02 risk | **Keep**, optional | |
|
||||
| 18 | `workload.availability.hours` | Business hours, extended or always | Customer | F02 risk | **Later** | |
|
||||
| 19 | `workload.availability.recovery_time` | RTO | Customer | Well-Architected reliability, F02 | **Keep**, optional | |
|
||||
| 20 | `workload.availability.recovery_point` | RPO | Customer | Well-Architected reliability (backup checks), F02 | **Keep**, optional | |
|
||||
| 21 | `compliance.industry` | The customer's industry | Customer | Report | **Drop**: `customer.industry` already holds it | |
|
||||
| 22 | `compliance.frameworks` | Regulations and standards that apply | Customer | F02 `compliance_scope` (gap 11), Well-Architected policy sets | **Keep**, essential: replaces `customer.regulatory` | |
|
||||
| 23 | `compliance.data_classification` | How sensitive the data is | Customer | Classification step (stated against found), F02 | **Keep** | |
|
||||
| 24 | `compliance.encryption.type` | Provider- or customer-managed keys | Evidence | Well-Architected security | **Keep**, settled from evidence | |
|
||||
| 25 | `compliance.encryption.key_rotation_days` | Key rotation period | Evidence (partly) | Well-Architected security | **Later** | |
|
||||
| 26 | `compliance.audit_logging.retention_days` | Audit log retention | Evidence (partly) | Well-Architected operations | **Later** | |
|
||||
| 27 | `compliance.audit_logging.immutable_retention_policy` | Undeletable audit logs | Evidence (partly) | Well-Architected security | **Later** | |
|
||||
| 28 | `networking.exposure` | Internal only or internet-facing | Evidence | Network step, Well-Architected security | **Keep**, settled from evidence | |
|
||||
| 29 | `networking.topology` | The network topology | Evidence | Network step, report | **Keep**, settled from evidence | |
|
||||
| 30 | `networking.hybrid_connectivity.enabled` | Private links to on-premises or another cloud | Evidence | Network step, F02 | **Keep**, settled from evidence | |
|
||||
| 31 | `networking.hybrid_connectivity.type` | VPN, ExpressRoute, Interconnect | Evidence | Network step | **Keep**, settled from evidence | |
|
||||
| 32 | `networking.hybrid_connectivity.bandwidth_gbps` | Bandwidth | Evidence (partly) | — | **Later** | |
|
||||
| 33 | `networking.egress_control.model` | Direct, provider-managed or a central appliance | Evidence | Network step, Well-Architected security | **Keep**, settled from evidence | |
|
||||
| 34 | `networking.egress_control.appliance_vendor` | Which appliance | Evidence (partly) | — | **Later** | |
|
||||
| 35 | `networking.cidr_allocations` | Allocated IP ranges | Evidence | Network step (address overlap) | **Keep**, settled from evidence | |
|
||||
| 36 | `governance.identity_source_of_truth` | The identity provider | Customer | — | **Later** | |
|
||||
| 37 | `governance.pipeline_authentication` | How pipelines authenticate | Not Discovery | — | **Drop** | |
|
||||
| 38 | `governance.environment_tiers` | Which environments exist | Evidence | Inventory (environment), F02 | **Keep**, settled from evidence (environment tags) | |
|
||||
| 39 | `operations.operating_model` | Who runs it day to day | Customer | Owners (ADR 0021), F02 | **Later**: owners now come from the CMDB and tags | |
|
||||
| 40 | `operations.support_hours` | Supported hours | Customer | F02 risk | **Later** | |
|
||||
| 41 | `operations.monitoring` | Monitoring and alerting | Evidence | Well-Architected operations | **Keep**, settled from evidence | |
|
||||
| 42 | `operations.change_process` | How changes are approved | Customer, or ITSM | F02 change frequency | **Later**, with an ITSM source | |
|
||||
| 43 | `integrations` | Other systems it exchanges data with | Evidence | Dependency graph (external nodes) | **Drop** as a field: the dependency graph holds it | |
|
||||
| 44 | `delivery.target_start_date` | When work starts | Not Discovery | — | **Drop** | |
|
||||
| 45 | `delivery.window_weeks` | The deadline | Not Discovery | — | **Drop** | |
|
||||
| 46 | `delivery.commercial_model` | How the work is contracted | Not Discovery | — | **Drop** | |
|
||||
| 47 | `delivery.iac_tooling` | Infrastructure-as-code tool | Not Discovery | — | **Drop** | |
|
||||
| 48 | `delivery.ci_cd` | Pipeline tool | Not Discovery | — | **Drop** | |
|
||||
| 49 | `delivery.team_size` | Engineers building it | Not Discovery | — | **Drop** | |
|
||||
| 50 | `cost.monthly_budget` | Monthly running budget | Customer | F02 TCO (indicative) | **Later**: F02 uses its rate card | |
|
||||
| 51 | `constraints.products_required`, `products_forbidden` | Mandated or ruled-out products | Not Discovery | — | **Drop** | |
|
||||
|
||||
## Totals, as recommended
|
||||
|
||||
| Recommendation | Fields |
|
||||
|---|---|
|
||||
| Keep | 21 (10 the customer states, 11 settled from evidence) |
|
||||
| Later | 16 |
|
||||
| Drop | 14 (6 already covered by Discovery's own sections or outputs, 8 delivery or design) |
|
||||
|
||||
## Also to decide
|
||||
|
||||
1. **Must every run have an intent,** or is it optional, with the Well-Architected review weighting pillars equally
|
||||
when there's none? Recommended: optional.
|
||||
2. **Where the completed values go:** a completed copy of the context file, or only in the package (a new `context`
|
||||
part). Recommended: the package only, so there's one artifact for F02.
|
||||
3. **ADR 0016's fate:** rewrite it to the fields kept here, within F01 and F02, with no shared catalogue.
|
||||
Reference in New Issue
Block a user