MCP server exposing the engenharia-de-requisitos skill content to any MCP-compatible client (Claude Desktop, Cursor, Cline, Continue, Zed, etc.)
Server exposes 5 tools with basic descriptions and no input schemas. Tool names follow verb_noun convention (list_*, validate_*), which is good. However, critical gaps undermine quality: (1) validate_user_story and validate_acceptance_criterion lack input schemas entirely, no type definitions, no parameter constraints; (2) descriptions are present but generic (50-150 chars), missing WHEN/WHY context and error guidance; (3) no output schemas documented; (4) no error handling guidance (what happens on validation failure?); (5) no pagination or result limits despite tools returning potentially large lists. The server is functional but falls short of production-grade agent tooling standards.
Return the titles and first-paragraph summaries of every examples/ file.
Return the hard rules from references/05-convencoes-interpop.md (the canonical Interpop convention layer). Each rule is non-negotiable when designing a backlog under this methodology.
Return the titles and first-paragraph summaries of every reference/ file. Equivalent to opening each file and reading the first paragraph after the H1. Useful when the client wants a quick map of the corpus before deciding which reference to fetch in full.
Validate an Acceptance Criterion against format and convention checks.
Validate a User Story against INVEST + Interpop naming conventions. Args: title: The User Story title as it appears on the OpenProject card. bdd: (optional) The Given/When/Then or Dado/Quando/Então scenario text that lives in the US Description field. If provided, structural checks run on it too. Returns: A markdown report with PASS/FAIL per check + explanation.
validate_user_story and validate_acceptance_criterion have NO input schemas visible in source. Parameters 'title', 'bdd', 'text' are documented in docstrings but not registered as JSON Schema with types/constraints.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract structured data. list_references returns markdown; validate_* tools return 'markdown report', structure is opaque.
No error handling guidance. validate_* tools return 'markdown report with PASS/FAIL' but do not specify what happens on malformed input, missing files, or parsing errors. No recovery hints for LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
list_* tools lack pagination and result limits. If references/ or examples/ directories grow large, responses could exhaust context window. No limit parameter, no cursor/offset, no total count returned.
Descriptions are functional but lack LLM-optimized context. 'Return the titles and first-paragraph summaries...' (65 chars) does not explain WHEN to call this vs fetching a specific reference, or what the agent should do with the summary. Baseline for A+ tools: 50-200 chars with clear WHAT/WHEN/WHY.