Universal runtime linker and multi-tool orchestration framework for AI agents (AGY, Codex, Pi, Claude Code, OpenCode). Provides audit validation, checklist generation, report aggregation, and visual cockpit for project elicitation and observability.
Critical gaps across all dimensions. Tool descriptions are verbose (200-400+ chars) but lack actionable structure for LLM selection. Input schemas are present but lack type definitions for most parameters, all four tools define parameters as strings without validation constraints, enums, or ranges. No output schemas documented. Error handling is absent. Tool naming is descriptive but some combine multiple concerns (q_cockpit bundles elicitation + observability + HTTP server). No evidence of idempotency, permission gates, or secret injection patterns. This server is not production-ready for agent integration.
Generates Complete Audit Suite: AUDIT_REPORT.md (Compliance Matrix + Detailed Findings), PLAN_DE_MEJORA.md (Prioritized P0/P1/P2 Remediation Roadmap with EARS specs), REMEDIATION_ISSUES.md (Actionable GitHub Issue templates), and PROPUESTA_EVOLUTIVA.md (Strategic Value, Performance, UX & Innovation Roadmap). Reads individual A{ID}-{slug}.md (Defects) and E{ID}-{slug}.md (Strategic Evolution) files.
Interactive Pre-Flight Architectural Decision Matrix for q-agent. Generates CONSTITUTION.md (architectural governance), ADR-0001 (Architectural Decision Record), and .q-agent.json (runtime configuration). Prompts user for decisions on architecture pattern, persistence strategy, transport interface, testing methodology, and workspace isolation.
Unified Visual Elicitation & Multi-Agent Observability Cockpit for q-agent. Combines Socratic Grill (interactive question cards, staged responses, visual diagrams/prototypes) and Mission Cockpit (TDD Task Kanban, Gate approval semaphores P03/P04/P08, artifact inspection). Provides HTTP server interface for project scanning, session management, git status, task tracking, and artifact inspection.
Deterministic Output Quality Gate for q-agent Plan C. Two operating modes: legacy mode validates monolithic BLUEPRINT.md deliverables; manifest mode validates individual A{ID}-{slug}.md files against audit-manifest.yml and produces AUDIT_GAPS.json for orchestrator retry loop.
No input parameter type definitions. All parameters declared as strings with no enum, range, pattern, or validation constraints. LLMs cannot infer valid values and will hallucinate inputs.
No output schemas documented. LLMs cannot plan downstream tool calls or extract structured data from results. Responses appear to be file paths or JSON, but structure is undocumented.
q_cockpit combines three distinct concerns: interactive elicitation (Socratic Grill), observability (Mission Cockpit), and HTTP server management. Should split into separate tools: start_elicitation_session, query_mission_cockpit, manage_http_server.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | 2026-07-28+ | v2 |
Descriptions lack WHEN/WHY guidance. 'Generates Complete Audit Suite' tells WHAT but not WHEN to call it vs validate_audit, or what prerequisites exist. LLMs cannot disambiguate between generate_report and validate_audit.
No error handling or recovery guidance. If manifest_path is invalid, level is out of range, or output_path is unwritable, no error classification or actionable recovery steps are defined.