A Temporal workflow orchestration server for managing multi-phase build pipelines with agent coordination, security auditing, and task queue integration
Server defines 10 tools with basic schemas and descriptions, but exhibits significant quality gaps. All tools have descriptions (positive), but most are under 100 chars and lack actionable context. Input schemas are present but sparse: parameters lack type constraints, enums, and validation guidance. No output schemas documented. Error handling is minimal, tools either succeed or raise exceptions without recovery guidance. Tool names are verb-noun style (good), but descriptions read like implementation notes rather than LLM-optimized guidance. The task_token pattern is well-documented in code comments but not reflected in parameter descriptions, forcing LLMs to infer the async completion model. No security annotations (readOnlyHint/destructiveHint) despite clear risk levels. Composition is reasonable (single responsibility per tool), but parameter relationships (e.g., task_id + build_name dependencies) are undocumented.
Apply auto-fixable security findings on the target agent. Dispatches a task to apply fixes for flagged issues.
Dispatch build-close-out task to the target agent. Runs final cleanup and verification after build completion.
Dispatch a build phase task to an agent via task queue. Encodes Temporal task token in YAML payload and suspends activity pending external completion via complete_activity.py
Dispatch the build implementation task to the target agent. Uses task_token pattern — completed externally when the agent finishes the build.
Notify Ted of blocking findings via Matrix and set task to input-required status. Sends structured notification about critical issues requiring manual approval.
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream parameter mappings and risking failed tool chains.
Parameters lack type constraints and validation guidance. 'agent_type' accepts free-form strings (should be enum: claudebox, security-agent, etc.). 'phase_number' has no min/max bounds. 'flags' array has no item type or length limits. LLMs will hallucinate invalid values.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | <=2025-11-25 | v2 |
Dispatch a build-plan-prefab task to the claudebox agent. Prefab creates stub files and directories from the build plan before execution. Uses task_token pattern — completed externally by the claudebox agent.
Read security triage YAML output, classify findings into blocks (critical), flags (auto-fixable), and info (informational). Retries with backoff as triage-output.yml may not be present immediately.
Write a security audit request artifact and dispatch a task to the security agent. Uses task_token pattern — completed externally when the security agent finishes.
Write YAML summary of workflow execution to agent-activity repository. Captures workflow ID, build name, timeline, phases completed, blocks/flags encountered, and artifact paths.
Poll until task transitions to approved status. Waits up to 7 days with 10-minute heartbeat intervals for manual block resolution.
Async completion model (task_token pattern) is undocumented in parameter descriptions. LLMs see 'execute_build_phase' and expect immediate results, not external completion. Descriptions must explain that these tools suspend and wait for external agents to call complete_activity.py.
No error handling guidance. Tools either succeed or raise exceptions. No recovery hints (e.g., 'If triage-output.yml is missing, retry after 30 seconds'). LLMs cannot distinguish retryable from fatal errors.
No security annotations (readOnlyHint/destructiveHint). Tools marked WRITE risk in metadata but not in schema. LLMs cannot determine which tools are safe to retry or which require confirmation before execution.