Multi-agent orchestration framework with MCP server support, session management, and integration with various external services
Both tools have minimal descriptions (under 50 chars) and lack detailed parameter documentation. Input schemas are present but sparse: 'conn' and 'config' are typed as generic objects with only brief descriptions, violating the requirement that every parameter have a clear, actionable description. No output schemas are documented. The tools perform write operations (setup_environment, setup_docker_credentials) but descriptions do not explicitly state they modify state or warn about side effects. No error handling guidance, no idempotency markers, and no recovery paths are visible. Tool names are verb-noun (acceptable) but descriptions are too terse to guide LLM selection.
Set up Docker registry credentials if needed
Set up ADEPT environment configuration
Parameter descriptions are missing or trivial. 'conn' is described as 'Fabric SSH connection' (28 chars) and 'config' as 'Configuration dictionary' (26 chars). LLMs cannot infer what fields these objects contain, what values are valid, or how to construct them. Descriptions must explain structure, required keys, and constraints.
No output schemas documented. Callers cannot know what fields are returned, their types, or how to chain results to downstream tools. This violates the requirement that 100% of A+ tools have documented return types.
Tool descriptions do not state that these are write operations with side effects. 'Set up ADEPT environment configuration' (40 chars) and 'Set up Docker registry credentials if needed' (44 chars) lack explicit warnings about state modification, idempotency, or retry safety. Agents need to know which calls are safe to retry.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Input schemas use generic 'object' types without property definitions. The 'conn' and 'config' parameters are typed as objects but their internal structure is not documented. LLMs cannot construct valid payloads without explicit schema properties, types, and descriptions.
No error handling guidance. Descriptions do not explain what can go wrong, how to recover, or what the LLM should do if setup fails. A bare error response gives the agent nothing to act on.