# Kendo Angular Agent Orchestrator

> Main entry point for building or refining UI with Kendo UI for Angular using a custom-agent handoff pipeline (kendo-angular-context-retrieval / kendo-angular-developer / kendo-angular-tester / kendo-angular-audit). Coexists with kendo-angular-orchestrator. Orchestrates the full workflow including accessibility, layout, components, theming, icons, and validation. Use when the user wants to build or modify a complete page, section, or UI feature with Kendo UI for Angular components and prefers the agent-handoff pattern. Trigger on "build a page", "create a dashboard", "implement a UI", "generate a form", "build UI with Kendo Angular", "create an Angular page", "#kendo_ui_agent_generator".

- Skill: `telerik/kendo-angular-agent-orchestrator` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add telerik/kendo-angular-agent-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/telerik/kendo-angular-agent-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: telerik (https://skillmd.com/u/telerik)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/telerik/kendo-angular-agent-orchestrator

---


# Kendo UI for Angular — Agent Orchestrator

**Current Goal:**

$ARGUMENTS

The orchestrator dispatches subagents, coordinates context loops, preserves prompt requirements, and aggregates results. It never writes app code, runs builds, or audits.

---

## Progressive Disclosure

Load detailed phase references only when entering that phase. Do not front-load all reference files.

| Phase | Load when | Reference |
|---|---|---|
| Context retrieval | Before planning or dispatching context shards | [references/context-retrieval.md](references/context-retrieval.md) |
| Plan execution | After context shard briefs are available | [references/plan-execution.md](references/plan-execution.md) |
| Developer dispatch | Before code-generation handoff | [references/developer-dispatch.md](references/developer-dispatch.md) |
| Validation and audit | Before building `files_to_check`, tester handoff, or audit handoff | [references/validation-and-audit.md](references/validation-and-audit.md) |
| Fix loop | When tester/audit findings require developer fixes | [references/fix-loop.md](references/fix-loop.md) |
| Completion | Before final response | [references/completion-checklist.md](references/completion-checklist.md) |

If a later phase sends `NEEDS_CONTEXT`, return to [references/context-retrieval.md](references/context-retrieval.md) for the context-loop mechanics, then re-run plan execution.

---

## Universal Subagent Contract

- Each subagent writes its output to a file and returns only the file path + `Status:` line.
- Each execution-producing subagent report starts with a compact JSON status block. Green-path reports should rely on that block and omit long Markdown detail unless there are findings, risks, or routing decisions to explain.
- Context briefs are full reference artifacts. Downstream handoffs receive brief paths and section hints, not pasted full documentation.
- Subagents use progressive disclosure: read each relevant brief's `Dispatch summary` first, then read only the referenced sections needed to complete the task.
- The orchestrator reads only compact context-producing summaries during plan execution. It does not read full context briefs unless a summary is missing or a later `NEEDS_CONTEXT` state requires targeted inspection.
- The orchestrator never reads full execution-producing outputs casually. It relays file paths verbatim and reads only the leading JSON status block plus structured `Files written` / `Findings` / `Concerns` metadata sections when a later phase needs routing data.
- Developer reports include a structured `selfCheck` block for source/static/build checks. Tester must consume it before deciding which duplicate static/build checks to skip, but tester owns runtime smoke, a11y smoke, and test execution.
- Report caps are mandatory: runtime findings are capped at the first 3 unique critical errors, a11y findings at the first 5 grouped rule violations, audit findings at Critical and Important by default, and fix-loop payloads at files changed plus applied findings.
- The orchestrator persists `dispatch-plan.md` and `layout-contract.md` to disk so prompt requirements and brief content survive the context window across fix loops.

Scratch directory: `tmp/orchestrator-run-<session_id>/`

---

## Kendo Fact Source Policy

- Authoritative Kendo/design-system facts come from context briefs, explicit handoff facts, and prior reports produced by this pipeline.
- Application source may be inspected for local usage patterns, existing imports, project wiring, and generated-code behavior.
- Package manifests, lockfiles, Angular config, root styles, and `index.html` may be inspected for dependency presence and setup.
- Do not inspect `node_modules`, dependency package source, package `.d.ts` declarations, source maps, generated declaration bundles, `.angular`, `dist`, or package caches to discover Kendo component APIs, inputs, outputs, directives, providers, payload types, accessibility requirements, icon names, theme variables, or layout utility classes.
- Developer, tester, and audit must not call MCP tools or external documentation lookup for Kendo/design-system facts. Context retrieval is the only stage that retrieves authoritative Kendo/design-system facts.
- If a Kendo/design-system fact is missing, ambiguous, or contradictory, batch it as a `Context-loop candidates` entry and route through the context loop instead of dependency-internal discovery.

---

## Workflow Map

1. **Context retrieval** — plan active Kendo/design-system context shards, dispatch `kendo-angular-context-retrieval` in parallel sub-groups of <=3, aggregate `context_brief_paths`.
2. **Plan execution** — read context brief summaries, extract the user request into `layout-contract.md`, and write `dispatch-plan.md` with a brief index, section hints, and autonomous developer acceptance criteria.
3. **Code generation** — dispatch one autonomous `kendo-angular-developer` task by default, then inspect developer status, structured self-check, and batched loop requests before validation.
4. **Validation smoke gate** — load validation rules, build `files_to_check`, pass developer self-check summaries to tester, and dispatch read-only `kendo-angular-tester` first. Tester may skip duplicate static/build checks already completed by developer against the final file state, then runs tester-owned smoke/test gates as needed.
5. **Audit polish gate** — dispatch read-only `kendo-angular-audit` only after tester is green or after remaining tester gaps are known to be intentionally skipped and non-blocking. Audit focuses on prompt fidelity, layout quality, accessibility, and Critical/Important polish.
6. **Fix loop** — convert tester and audit findings into autonomous developer fix tasks, then re-run only the affected gates/scopes until clean.

Status routing summary:

- `kendo-angular-context-retrieval DONE` → add path to `context_brief_paths`.
- `kendo-angular-context-retrieval NEEDS_CONTEXT` → re-dispatch only that shard with `prior_brief_path`, `gap_notes`, and a fresh output path.
- `kendo-angular-context-retrieval BLOCKED` → drop shard, record warning, continue.
- `kendo-angular-developer DONE` → continue only after `Developer self-check` is present and contains no `concern` categories.
- `kendo-angular-developer DONE_WITH_CONCERNS` → read `Concerns`, `Developer self-check`, and `Batched loop requests`; route context-loop candidates first, then fix-loop candidates, or continue only for explicitly non-blocking concerns.
- `kendo-angular-developer NEEDS_CONTEXT` → context loop.
- `kendo-angular-developer BLOCKED` → surface blocker unless a narrower context-loop or fix-loop candidate is listed and safe to dispatch.
- `kendo-angular-tester GREEN` → dispatch audit unless the active path explicitly skipped audit as unavailable or out of scope.
- `kendo-angular-tester NEEDS_CONTEXT` → context loop.
- `kendo-angular-tester BLOCKED` with fix-required findings or build/runtime failure → fix loop, except external blockers that require user intervention. Do not dispatch audit for the same iteration until tester is green.
- `kendo-angular-audit DONE` after tester green → complete.
- `kendo-angular-audit DONE_WITH_CONCERNS` / `BLOCKED` → fix loop.
- `kendo-angular-audit NEEDS_CONTEXT` → context loop.

Null-response routing: if a subagent returns no usable status/path, retry once with a status-only prompt and the same output path. If the retry is also empty, mark that handoff `BLOCKED (null_response)` and continue only when the workflow can safely surface the blocker.

---

## Non-Negotiables

- Context-retrieval shards are dispatched in staged parallel groups of <=3.
- Validation rules are loaded during the validation/audit phase; there is no always-active validation context shard.
- Tester is read-only. It reports validation/build findings and writes only `validation-brief.md`; it never edits source.
- Audit is read-only. It reports findings and writes only `audit-brief.md`; it never edits source or runs builds.
- Tester is the runtime smoke, a11y smoke, and test gate. Audit is deferred until tester returns green for the current iteration. Audit must not read tester output, but the orchestrator may use tester status to decide whether audit should be dispatched.
- The orchestrator does not write app code, run `ng build`, or perform quality audit work.
- When layout is active, `@progress/kendo-theme-utils` must be validated as both installed in `package.json` and referenced in CSS/theme setup.
- `files_to_check` is built before tester/audit from execution outputs' `Files written` sections.
- Validation starts only after developer outputs are clean or after explicitly non-blocking developer concerns have been recorded.
- Fix-loop reruns are targeted to files touched by the fix unless a shared shell, routing, style, or configuration file changes.
- Any unresolved `BLOCKED` shards, external blockers, or unresolved `NEEDS_CONTEXT` states are surfaced in the final answer.