Files
cp1-agents/individual-agents/ALZ-F02: Assessment & Disposition Workflow Agent/docs/adr/0009.md
Jonathan Boniface e22d037ab0 ALZ-F02 Assessment: individual agents, intake, rate card input, critic fixes
- 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>
2026-11-05 22:13:25 +00:00

2.3 KiB

0009. The rate card is a run input, its JSON as text; Assessment has no upload step

Status Accepted
Date 2026-11-05
Decided by Product owner, 2026-11-05: "Run input text" (the rate card is a run input, its JSON pasted into the run form or passed by the script)
Requirements changed Supersedes ADR 0003 (the rate card as an uploaded JSON file). ALZ-ASM-01, 04 and 06 read the rate card from the run input rate_card_document

Context

  • The first Assessment run, exec_20d55cfe6fd7, stopped at the intake (ADR 0008): "0 Discovery packages among the selected artifacts". The Discovery package was selected correctly.
  • The cause is how KAB passes run inputs. Every run input reaches every step. The rate card was uploaded as the run's file, so it also reached p1, the parse step wired to the Artifacts step's files. The parse activity reads a file input before files, so p1 parsed the rate card again and never saw the package. Its output was the rate card's text.
  • So while the rate card is uploaded as file, no Assessment agent can read Discovery. Discovery is unaffected: it has one parse step, and its uploads are meant for it.

Decision

  • No upload step. The workflow starts with a1 (Artifacts) and p1 (parse), so file is never a run input.
  • The rate card is the run input rate_card_document: its JSON as text, in the same format as before (Feature README). The planner, the disposition agent and the critic take it under the same name, so no agent's behaviour changes; only the descriptions say where it comes from (planner, disposition and critic 0.1.1).
  • scripts/kab_run_workflow.py reads an input from a file with --input rate_card_document=@<path>.

Consequences

  • The parse step only ever sees the Discovery package, and the intake's check means something.
  • In the KAB run form the rate card is pasted, not uploaded. It's small (a few kilobytes), so a text field is enough. A large rate card would be better as a project artifact selected beside the package, which the intake would then have to tell apart.
  • Any future step that parses an upload in a workflow that also parses artifacts hits the same rule. Keep one file-parsing source per workflow, or none.