Critical gaps across naming, descriptions, and schemas. Tool names use wildcard patterns (think_*, ship_*, roadmap_*, signal_*) that are inferred rather than explicitly registered, cannot verify actual tool definitions. Only 4 of 9 tools have visible input schemas; 5 tools lack any schema documentation. Descriptions are present but generic (e.g., 'Structured reasoning tools family', under 50 chars, below the 194-char baseline). No output schemas documented. Error handling and recovery guidance absent. Composition issues: roadmap_export, roadmap_get, roadmap_set_status, tracker_setup have schemas but lack descriptions of what they return or when to use them.

• Expand wildcard tool families into explicit, individually registered tools with unique names (e.g., think_reason, think_reflect, ship_execute, ship_track). Each tool must have its own description (50 - 200 chars), input schema with typed parameters, and documented output schema.
• Add output schemas to all tools. Document what fields are returned, their types, and which fields are required for chaining to downstream tools. Example: roadmap_get should document that it returns {id, title, status, created_at, updated_at}.
• Rewrite descriptions to follow the pattern: '[VERB] [OBJECT]. Use this when [CONTEXT]. Returns [STRUCTURE].' Example: 'Retrieve roadmap chunks by ID with optional field projection. Use this to fetch specific roadmap items before updating or exporting. Returns an array of chunk objects with id, title, status, and optional projected fields.'
• Add error handling guidance to each tool. Document common failure modes (e.g., 'Chunk ID not found', 'Invalid status value') and what the LLM should do (retry, ask user, call search_roadmap first).
• For tracker_setup, document the dry_run behavior explicitly: 'If dry_run=true, validate the connection without creating any issues or webhooks. Returns a summary of what would be created.' This prevents accidental side effects.

Inferred effective spec: 2025-06-18+.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry