- Six declarative agents generated from the v1.1 stories (scaffold_from_stories.py, ADR 0001),
and a 9-step workflow export (build_workflow.py).
- Code-only intake (ADR 0008) verifies the one Discovery package in code before any agent.
- The rate card is the run input rate_card_document; no upload step (ADR 0009).
- Critic 0.1.6 after live runs on crucible-kab-dev:
- K-12 model independence checked at build time against each agent's deployed model
(ADR 0010); the critic reports it from its two inputs;
- receives in_cloud_estate for K-10; an unverified K-10 never fails the run alone;
- K-08 allows the scoring note to list findings as advisory, as ALZ-ASM-04 must;
- carries ALZ-ASM-03's and ALZ-ASM-04's rule sections, copied by the scaffold, so it can
recalculate risk, confidence and TCO.
- The scaffold refuses to regenerate unless every story file is present.
- Case azure-crucible-kab-dev-assessment with an illustrative rate card.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.7 KiB
4.7 KiB
Context: individual agents, ALZ-F02 Assessment & Disposition
Facts for this Feature's individual-agents pattern, for coding agents. Repository-wide facts are in ../../.agents/CONTEXT.md. Per-agent context is in <agent>/.agents/CONTEXT.md.
Pattern
- Six declarative agents, one per ALZ-ASM story, plus the code-only intake (
s0, ADR 0008). Only ALZ-ASM-02 and ALZ-ASM-05 declare MCP tools; the other four and the intake have none. - The workflow (
workflows/cp1-alz-assessment-individual.json) is the orchestration. Step order comes fromparallelGroupandexecutionLevel, and data fromfrom_steps. The step map isSTEPSinscripts/build_workflow.py, and the scaffold reads it for each agent's context file. - Order:
a1the Discovery package artifact,p1parse, thens0intake (checks the Discovery package in code; a refusal fails the run), thens1planner, thens2profiler,s3risk ands4security posture in parallel, thens5disposition, thens6critic.s6has a human approval, which isdisposition_signoff(ADR 0004). - Nothing persists between steps except their replies, as in F01 (its ADR 0010).
Sources of truth
| What | Where |
|---|---|
| Requirements | ADO Feature 3214442 and stories 3214459–3214464. The v1.1 story files are in the engineering hub workspace, at drafts/cp1/agentic-landing-zone/stories/F02-assessment/ |
| Decisions on the board | Feature 3214442 "Decisions" table (2026-10-30 and 2026-11-02) |
| Changes to requirements | docs/adr/ (this pattern only) |
| MCP servers | ../../mcp-servers/ (existing, shared, unchanged) |
| Discovery's output shapes | ../ALZ-F01: Discovery Workflow Agent/cp1-*/schemas/output.json |
Platform facts (verified in modernization-platform @ c89aedcb9)
select_artifactshas exactly one output,artifacts: per-file records with base64contentwhile the selection fits the inline allowance (8 MiB live). Beyond that, a record carries only afile_path(migration 024;artifacts_activities.py).parse_assessment_filesaccepts those records under any input key (fileshere). It returnsparsed_content, the texts joined by\n\n---\n\nwith no names, andfile_metadata, which has the names in the same order (data_file_processing.pyparse_files).- A record with no inline content is skipped silently by the parser. An oversized Discovery output therefore arrives as a missing document, and the agents report it.
- Static inputs are applied after run inputs. So the
a1step leavesartifact_idsto the run (from_workflow) unless--artifact-idfixes them in the export. - Step outputs are registered as project artifacts only at the end of a run, and only when it has a
project_id. The artifact name is{execution_id}_{step_id}. - Review decisions go to the activity log (
record_review_decision), not onto artifacts. That's why the approval reference is a run input (ADR 0002). - Models served by the cluster's LiteLLM:
gpt-5.6-sol,gpt-5.4,gpt-4o(checked 2026-11-01). - No upload step (ADR 0009). KAB hands every run input to every step, and
parse_assessment_filesreads afileinput before thefileswired to it, so a rate card uploaded asfilewas parsed byp1in place of the Discovery package (runexec_20d55cfe6fd7). The rate card is the run inputrate_card_document, its JSON as text. - Run
exec_4be193061c41(2026-11-05): intake verified the package; every step ran. Two faults: (1) every Azure tool call from ALZ-ASM-02 and ALZ-ASM-05 got HTTP 401 from Azure, because the project's Azure Discovery connection holds anaz account get-access-tokentoken (about an hour); refresh it, or store a service principal, before a run. (2) The critic failed K-12 on a Discovery agent's model read from the package; critic 0.1.2 compares onlycritic_modelwithexecutor_modelsand getsin_cloud_estatefor K-10. - Never pass the scaffold an option:
scaffold_from_stories.py --helponce took--helpas the stories folder and deleted the six agent folders (restored from the deployed images and the scaffold). It now refuses unless every story file is there. - K-12 at build time (ADR 0010):
build_workflow.pyrefuses a critic deployed on an executor's model, reading each agent'sLITELLM_MODEL; critic 0.1.4 reports K-12 from its two inputs. Runexec_0b0afb70b8b9(first with live Azure evidence: posture 0.69, 10 findings) failed only on K-12. - The critic's recalculation rules (critic 0.1.6): the scaffold copies ALZ-ASM-03's and ALZ-ASM-04's rule sections into the critic's prompt (
RECALC_RULES), so K-04 to K-06 recalculate with the producers' own rules. Before 0.1.6 the critic had none (runexec_1779863642d6, K-04).