Chief-of-Staff MCP server for keeping AI coding projects sane.
Critical gaps across all 13 tools. Descriptions exist but are often vague or lack actionable guidance for LLM selection. No parameter descriptions at all (all schemas show empty properties). No documented output schemas. Error handling and recovery guidance absent. Tool names follow verb_noun convention (positive), but lack of schema detail and parameter guidance makes this server unsuitable for production agent use.
Read-only consistency audit: duplicate ids, dependency links, missing artifacts, overlaps, orphans; no writes
Read-only guide: external API provider config, model mapping, API key env presence (no values, no network)
Inspect Chief-of-Staff project health and task progress
Read-only preflight before dispatch_worker: task/config/deps/route hints; no writes, no network, no secrets
Read-only next-step advisor from task queue (blocked/failed/waiting/running/pending/done); no writes or dispatch
Initialize or repair missing .chief layout (dirs, empty tasks.json, default config); dry_run to preview only
ALL 13 tools have empty input schemas (properties: {}). No parameters are defined, typed, or described.
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing unstructured parsing and increasing hallucination risk.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
Spawn a detached External API Worker child process for one pending task. Returns immediately (background); Chief should NOT block the user waiting for the worker. Final result lands in `.chief/results/<task>.md` (`result_file`) plus a one-line `summary`; logs stream to `.chief/logs/<task>.log`. Provider key in config is free-form; the worker script path is resolved relative to the installed package, not the user project.
Get lane-based worker board for current tasks
Read worker task status (status / pid / provider / model / result_file / log_file) plus a short log tail. Default Chief usage: read this when the user asks 'is it done yet?'. Do NOT auto-open `result_file` or read the full log unless the user explicitly asks.
Read final outcome paths and the one-line `summary` for a task (status / outcome / result_file / log_file / summary / error). Default Chief usage: report these fields back to the user; do NOT inline the full result file content unless the user explicitly asks for it.
Append planned tasks into .chief/tasks.json
Prepare one pending task for Cursor Agent Worker handoff
Submit Cursor Agent Worker execution result back to chief
Descriptions lack actionable guidance. E.g., 'Append planned tasks into .chief/tasks.json' does not explain WHEN to call this, WHAT format tasks need, or WHAT it returns. LLMs cannot distinguish this from similar tools.
No error handling or recovery guidance. Tools do not document what errors can occur, whether they are retryable, or what the LLM should do next.
No idempotency or confirmation patterns for destructive operations. dispatch_worker and submit_worker_result modify state but lack dry-run or confirmation steps.