Agent routing, dispatch orchestration, and configuration management system for Claude Code with multi-backend support, telemetry analysis, and Telegram integration
Critical failures across naming, descriptions, and schemas. Most tools lack proper verb-noun naming (e.g., 'agent-router' instead of 'route_agent', 'hive-append' instead of 'append_to_hive'). Parameter descriptions are sparse or missing entirely. Input schemas visible for only ~6 tools; most lack documented output schemas. No error handling guidance. Tools in archive/ folder suggest abandoned/orphaned code. Descriptions range 20-200 chars but many are vague (e.g., 'Claude wrapper' for tool #10). No security annotations, no permission gates, no audit trail patterns.
Routes task queries to appropriate agent from registry based on capability matching, intent detection, and weighted scoring. Resolves backend execution (Claude, OpenAI Codex, fallbacks) and checks cost policies and quota exhaustion.
DevFocus trigger when Claude awaits user input. Pauses music, plays alert, brings terminal to front, sends macOS and Telegram notifications.
DevFocus trigger for build/test errors. Pauses music, plays alert, sends macOS and Telegram notifications.
Claude wrapper that injects pending report processing prompts when called interactively with no arguments. Supports bypass mode to skip permissions.
Claude wrapper using free models (Groq Llama 70B by default). Injects pending reports and skips permissions.
Claude wrapper using local models via Ollama (Qwen 2.5 Coder 7B by default). Injects pending reports.
Naming convention violations: tools use kebab-case (agent-router, hive-append, telegram-poll) instead of verb_noun pattern (route_agent, append_to_hive, poll_telegram). LLMs cannot reliably parse intent from non-standard names.
Missing output schemas: 12 of 18 tools lack documented return types. route_optimizer, telegram-poll, telegram-agent have no visible schema definitions. LLMs cannot plan downstream tool calls without knowing response structure.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
LiteLLM-based free model proxy. Translates Anthropic API calls to free models (Groq). Manages proxy lifecycle (start/stop/status/restart) on port 4123.
Appends task record to shared hive log (~/.claude/hive/tasks.jsonl) with UTC timestamp. Records agent name, status (done|failed|started), and summary.
macOS native notification via osascript. Displays notification with title, message, and optional sound (Glass, Ping, Sosumi, etc.).
Unified notification dispatcher. Sends notifications via sound, macOS native notifications, or Telegram. Supports event triggers (build-error, task-done, ai-question).
Outputs PROJECT_INDEX signal by parsing .claude/index.md frontmatter (project, stack, focus fields) and first body line. Silent if no index found.
Analyzes dispatch telemetry to identify suboptimal model assignments. Recommends model swaps when alternate models achieve >=95% success rate at lower cost with >=5 samples.
Music pause/resume and alert sound control. Supports Spotify and Apple Music. Respects mute flag (~/.claude/notifications-mute).
DevFocus trigger for task completion. Resumes music, plays alert, sends macOS and Telegram notifications.
Persistent Claude ↔ Telegram bridge agent. Maintains continuous Claude session in stream-json mode, forwards Telegram messages directly to Claude, returns responses to Telegram.
Bidirectional prompt: accepts input from either Telegram or terminal, whichever responds first within timeout. Returns first non-empty response.
Telegram ↔ Claude Code bridge. Polls Telegram for messages, images, documents, voice. Executes Claude tasks and sends results back to Telegram. Supports TMUX session injection.
Waits for new Telegram message and outputs to stdout. Respects offset tracking to avoid duplicates.
Vague descriptions for wrapper tools: 'Claude wrapper that injects pending report processing prompts' (tool #10) and 'Claude wrapper using free models' (#11) do not explain WHEN to use each variant, what distinguishes them, or what side effects occur. Descriptions under 50 chars or generic.
No error handling guidance: tools lack recovery instructions. E.g., agent-router says 'NO_MATCH, fallback to A1' but does not explain when/why this occurs or what the LLM should do next. No categorization of retryable vs fatal errors.
Orphaned/archived code: 6 tools (telegram-poll, telegram-agent, telegram-ask, telegram-wait, macos-notify, notify triggers) reside in archive/orphan-skills-20260804/ folder, suggesting deprecated or unmaintained status. No deprecation warnings in descriptions.