An artifact manager for system specifications with MCP (Model Context Protocol) support. Provides resources and tools for managing specification documents across multiple domains (requirements, use cases, tasks, QA, problems, goals, risks, decisions, SOPs, features, verification cases, system requirements, and architecture decision records).
26 tools with consistent naming (verb_noun pattern: get_*, list_*) and basic descriptions. All tools have input schemas with typed parameters and descriptions. However, descriptions are minimal (10-50 chars, well below the 194-char baseline for A+ tools), lack context on WHEN to use each tool, and provide no guidance on tool composition or dependencies. No output schemas documented. All tools are READ_ONLY, reducing error handling complexity, but pagination support is mentioned without explicit limit documentation. Tool names are clear but descriptions do not explain the distinction between similar resource types (e.g., why choose get_req vs get_uc vs get_tsk). No error recovery guidance.
Retrieve an architecture decision record document by ID
Retrieve a decision document by ID
Retrieve a feature document by ID (feat-NNN-slug format)
Retrieve a goal document by ID
Retrieve a problem statement document by ID
Retrieve a question-and-answer document by ID
Retrieve a requirement document by ID
Descriptions are critically short (10-50 chars vs 194-char baseline). They lack context on WHEN to use each tool, what distinguishes similar resources, and how tools compose. E.g., 'Retrieve a requirement document by ID' does not explain when to call get_req vs get_uc or what a requirement is in this domain.
Output schemas are not documented. LLMs cannot infer what fields each tool returns, making it impossible to plan downstream tool calls or extract required data for chaining.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | <=2025-11-25 | v2 |
Retrieve a risk document by ID
Retrieve a standard operating procedure document by ID
Retrieve a system requirements specification document by ID
Retrieve a task list document by ID
Retrieve a use case document by ID
Retrieve a verification case record document by ID
List all architecture decision record documents with pagination support
List all decision documents with pagination support
List all feature documents with pagination support
List all goal documents with pagination support
List all problem statement documents with pagination support
List all question-and-answer documents with pagination support
List all requirement documents with pagination support
List all risk documents with pagination support
List all standard operating procedure documents with pagination support
List all system requirements specification documents with pagination support
List all task list documents with pagination support
List all use case documents with pagination support
List all verification case record documents with pagination support
Pagination parameters (page, page_size) lack constraints. No documented limits on page_size, no guidance on max results per call, and no mention of total_count or next_cursor in responses. This risks context window exhaustion.
No error handling guidance. Tools do not document what happens on invalid ID, missing resource, or API failure. LLMs receive no recovery hints (e.g., 'Try list_req() to find valid IDs').
26 tools with identical patterns (get_X, list_X) create cognitive load for LLMs. No tool composition guidance or dependency hints. LLMs must reason independently about which resource type to query.