A full-stack project management system with AI-powered GitHub repository analysis, project creation, and task management. Integrates LangGraph agents with MCP for extended tool capabilities.
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. read_github_repo and read_repo_file have acceptable descriptions (100+ chars) and input schemas with type info, but lack output schema documentation. create_project has a complex schema with nested objects (tasks, milestones) that lack internal field definitions. No tool has error handling guidance or recovery hints. Parameter descriptions are present but minimal (10-30 chars typical). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk profiles.
Create a new project entry in the dashboard with all relevant details.
Fetch public data from a GitHub repository including metadata, languages, contributors, README, open issues, file tree, and manifest files.
Read a single file from a public GitHub repository.
create_project has nested object parameters (tasks, milestones) with no internal field schema. Each task/milestone object lacks type definitions for title, description, priority, status fields. LLMs cannot infer required vs optional fields or valid value ranges.
No output schemas documented for any tool. LLMs cannot plan downstream operations or extract required fields. read_github_repo should document what fields are returned (languages, contributors, issues, file_tree structure).
No tool annotations despite clear risk profiles. read_github_repo and read_repo_file are READ_ONLY but lack readOnlyHint. create_project is WRITE but lacks destructiveHint. Agents cannot distinguish safe from risky operations.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | <=2025-11-25 | v2 |
Parameter descriptions are minimal (10-30 chars). 'GitHub URL or owner/repo string' is adequate, but 'Project name', 'Project description' lack context on length limits, required format, or constraints. Baseline is 72 chars average.
No error handling guidance. If read_github_repo fails (404, rate limit, timeout), no recovery hint is provided. If create_project fails validation, no actionable error message guides the LLM to self-correct.