Vogt exposes 61 tools via STDIO with minimal schema visibility. Tool names follow verb_noun convention (vogt_backlog, vogt_work_create, etc.), which is positive. However, critical gaps undermine quality: (1) No input schemas are visible in the provided source code, only tool names and descriptions appear in stdio.py. (2) Descriptions are extremely terse (10-30 chars), far below the 50-200 char baseline for LLM-optimized tools. E.g., 'List backlog items' (19 chars) lacks context on when to call it vs vogt_work_list. (3) No parameter documentation is evident, tools like vogt_work_create and vogt_work_update have no visible input specs. (4) Output schemas are undocumented. (5) Error handling is not visible. Per the hard rules: tools with no visible input schema score 0 on schema; descriptions under 20 chars score 0-20 on description. Average across 61 tools: ~15/100.

• Expand all tool descriptions to 50-200 characters. Example: 'vogt_work_list' → 'List work items in the current project. Returns work_id, title, status, and assignee. Use this to discover available work before calling vogt_work_get or vogt_work_update.'
• Document input schemas for all tools. For vogt_work_create, specify required fields (title, type), optional fields (description, assignee_id), and constraints (title max 255 chars, type enum: task|bug|feature). Use JSON Schema with type and description for each parameter.
• Document output schemas. For vogt_work_list, specify: returns array of {work_id, title, status, assignee_id, created_at}; includes pagination (limit, offset, total_count); cap results at 50 items.
• Add error handling guidance to WRITE tools. Example for vogt_work_create: 'If title is empty, returns 400 with message "title required". If assignee_id is invalid, returns 404 with message "assignee not found; call vogt_actor_list to find valid IDs". Retryable: false.'
• Distinguish similar tools with richer descriptions. vogt_work_list vs vogt_backlog: clarify which filters apply, what 'backlog' means (unstarted work?), and when to call each. Add dependency hints: 'Call vogt_project_list first if you need to filter by project_id.'