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

CP1 agents

The KAB agents and workflows for the CP1 Epic "Agentic Landing Zone" (ADO 3214440), built on the KAB agent runtime in KAB's agent shape (agent.yaml, prompt.md, schemas/, eval/).

Each Feature is built in two patterns, and which one is adopted hasn't been decided:

Pattern Folder Shape
Sub-agents sub-agents/ One orchestrator agent per Feature, with the Feature's stories as its sub-agents. It keeps a shared run workspace, and a verdict enforced in code.
Individual agents individual-agents/ One declarative agent per story, chained by the KAB workflow, cp4-agents style
Feature Sub-agents Individual agents
ALZ-F01 Discovery (3214441) built: 1 orchestrator, 8 sub-agents built: 8 agents
ALZ-F02 Assessment & Disposition (3214442) not started built, not deployed: 6 agents
ALZ-F03 Strategy Synthesis not started not started

Layout

cp1-agents/
├── sub-agents/<Feature>/            the sub-agent pattern, one folder per Feature
│   ├── cp1-…-orchestrator-agent/    the agent (Dockerfile, kubernetes/, docs/, .agents/)
│   ├── workflows/                   the Feature's KAB workflow export
│   └── scripts/                     scripts only this Feature uses (build_workflow.py, dry_run.py)
├── individual-agents/<Feature>/     the individual-agents pattern, one folder per Feature
│   ├── cp1-…-agent/ …               one agent per story
│   ├── docs/adr/  .agents/          the pattern's decisions and plan for this Feature
│   ├── workflows/  scripts/
├── mcp-servers/                     MCP servers shared by both patterns (alz-discovery-sample)
├── scripts/                         shared: check_agents, render_k8s, kab_import_workflow, kab_front_steps, MCP server tools
├── deploy/                          deploy profiles: where to deploy, never keys
└── docs/
    ├── deployment.md                building, rendering and deploying every component
    ├── platform-issues/             KAB platform problems found while building these agents
    ├── source-material/             the inputs: agent shapes, KAB workflow exports, workflow documentation
    └── strategy-outline/

Each agent keeps its own Dockerfile and kubernetes/ folder. Kyndryl's agent CI builds one folder at a time, and the kubernetes/ files keep the CI's placeholders. Everything else that the two patterns or several Features share exists once, at the root.

The Feature folder names contain spaces and a colon. Quote them in a shell. Git can't check out a path that contains : on Windows, so clone the repository in WSL or on Linux or macOS.

Common tasks

From the repository root:

# Check every agent folder
find sub-agents individual-agents -mindepth 3 -maxdepth 3 -name agent.yaml -print0 | xargs -0 -n1 dirname -z \
  | xargs -0 python3 scripts/check_agents.py --runtime-image cruciblecoredevacr.azurecr.io/kab/agent-runtime-adk:0.35.7

# Rebuild a Feature's workflow export, then validate it against KAB and import it
python3 "sub-agents/ALZ-F01: Discovery Workflow Agent/scripts/build_workflow.py"
python3 scripts/kab_import_workflow.py "sub-agents/ALZ-F01: Discovery Workflow Agent" --project-id <id> [--apply]

# Render the manifests for a deploy
python3 scripts/render_k8s.py deploy/crucible-kab-dev.yaml [<component>]

The secrets, the MCP gateway registration and the order of the steps are in docs/deployment.md.

Checks

.gitea/workflows/check.yml runs on every push:

  • scripts/check_agents.py: cp4-agents' folder rules (pinned runtime image, Kyndryl CI's placeholders, no secrets). An agent may carry app/ only if it declares functions, hooks or sub-agents.
  • The orchestrator's dry run: its code, with no model and no MCP server.
  • Every Feature's workflow export must match its agents' contracts.
Description
No description provided
Readme 3.7 MiB
Languages
Python 98.7%
Dockerfile 1.3%