Safety-first control plane for native coding-agent harnesses
Critical gaps across all dimensions. Tool descriptions are present but highly technical and domain-specific (e.g., 'Explicit OWNER command: evaluate PLAN, accept, create durable dispatch...'), making them difficult for LLMs to parse. No visible input/output schemas in the provided source code, only type imports and references. Parameters are not documented with descriptions, types, or constraints. The 18 tools appear to form a complex task lifecycle system but lack the clarity needed for reliable LLM invocation. Naming is verb-based (execute_, create_, get_, list_, claim_, checkpoint_, resume_, report_, recover_, close_, cancel_, delegate_, await_) which is good, but descriptions do not explain WHEN to use each tool or what distinguishes similar operations (e.g., claim_task vs claim_next_task). No evidence of error handling guidance, pagination support, or output field documentation.
Create a READY implementation or diagnosis task from the current clean Git baseline.
No input/output schemas visible in source code. All 18 tools have schema score of 0. Cannot verify parameter types, constraints, or return structures. LLMs cannot reliably invoke tools without documented schemas.
17 of 18 tools lack descriptions (only execute_c2c_plan and create_task have brief descriptions). LLMs cannot determine when to select these tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 31 | 2025-06-18+ | v2 |
Explicit OWNER command: evaluate PLAN, accept, create durable dispatch, and request controlled launch. Reuse all identities after response loss. Does not create or resume tasks; launch is not completion.
Descriptions that exist (execute_c2c_plan, create_task) are highly technical and domain-specific, using jargon like 'OWNER command', 'durable dispatch', 'C2C controller mode' without explaining what these mean or when an LLM should invoke the tool. Descriptions do not follow the WHAT/WHEN/RETURN pattern.
No parameter descriptions visible. Tools like claim_task, checkpoint_task, and delegate_task have parameters (inferred from imports and function signatures) but no documentation of what each parameter means, its type, valid values, or constraints. LLMs cannot reliably fill parameters.
No error handling guidance. Tools like recover_task and report_blocked suggest error scenarios but provide no documentation of what errors can occur, how to interpret them, or what the LLM should do next (retry, ask user, abort).