AI orchestration backend for NexusOS AI platform with specialist agents for career, resume, interview prep, study planning, internship search, and life scheduling
Critical failures across naming, descriptions, and schemas. Tool names lack action verbs (e.g., 'career_recommendation_engine', 'study_plan_builder', 'resume_review_service' are noun-heavy, not verb_noun). Descriptions are present but generic (avg ~60 chars, well below 194-char baseline). Input schemas visible for only 6/12 tools; most lack parameter type definitions. No output schemas documented. Tools like 'calendar.list_events' and 'time_management_skill' have empty input objects with no description of what they return. No error handling guidance. No tool annotations (readOnlyHint, destructiveHint). Source code shows agent implementations but NOT explicit MCP tool registration with full schemas.
List calendar events for the user
Suggest calendar-friendly work blocks for study planning
Recommend career opportunities and growth paths aligned to user interests
Search for documents by query term
Parse and assess study goals for exam preparation
Search for relevant internship opportunities and summarize fit and deadlines
Prepare interview coaching notes and practice guidance for the target role
Tool names lack action verbs. 'career_recommendation_engine', 'study_plan_builder', 'resume_review_service' are noun-heavy. Should be 'recommend_career_path', 'build_study_plan', 'review_resume' to signal intent to LLMs.
No output schemas documented. Tools return unstructured responses; LLMs cannot plan downstream calls or extract typed fields. E.g., 'career_recommendation_engine' returns what? A list of jobs? A roadmap object? Unknown.
Empty input schemas for 'calendar.list_events' and 'time_management_skill' ({}). No description of what parameters control behavior or what the tool returns. Violates pattern:tool-description.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | <=2025-11-25 | v2 |
Review a resume and provide actionable feedback about impact, completeness, and positioning
Search for information based on query terms
Create a study and time-management plan for user's current goals
Create an exam-readiness plan with focused study sessions and progress checkpoints
Recommend balanced personal routines and time-management habits for daily life
Descriptions are generic and under 100 chars (avg ~50 chars vs 194-char baseline). E.g., 'Recommend career opportunities and growth paths aligned to user interests' lacks WHEN to use, WHAT it returns, or dependencies. Insufficient for LLM tool selection.
No error handling guidance. Tools do not document what happens on failure, whether errors are retryable, or what the LLM should do next. No recovery paths.