MCP-backed product design architecture, knowledge, verification, and quality gates.
21 tools with consistent but minimal documentation. All tools have descriptions (10-50 chars, below the 50-200 char baseline for LLM optimization) and basic input schemas. However, schemas lack depth: most parameters have no type constraints, enums, or validation guidance. No output schemas documented. Parameter descriptions are generic ('Path to...', 'Identifier of...') without format, range, or constraint details. No error handling guidance. Tools read-architecture through read-usability-evaluation are near-identical (5 knowledge-area readers), violating single-responsibility principle. No tool annotations (readOnlyHint, etc.). Composition is weak: agents cannot chain tools effectively without explicit output schema documentation.
Aggregate multiple quality gate results into a comprehensive report
Audit a repository for design engineering violations and anti-patterns
Compile a design plan from a product design brief and design deliverables
Evaluate a corpus benchmark against design quality criteria
Evaluate a heuristic usability review against the ZtotheZ Design Engineering heuristic framework
Evaluate an interface comparison review against a comparison methodology
List all projects in the ZtotheZ Design Engineering portfolio
Read Markdown files from the architecture knowledge area
Five near-identical knowledge-area reader tools (read-architecture, read-design-intelligence, read-figma-and-design-systems, read-ux-patterns, read-usability-evaluation) violate single-responsibility and composition principles. LLM must reason between similar names; should consolidate into one parameterized read-knowledge tool with an 'area' enum.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., what does validate-product-brief return? What fields enable chaining to compile-design-plan?). Agents must guess structure.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Read Markdown files from the design intelligence knowledge area
Read Markdown files from the Figma and design systems knowledge area
Read a detailed report for a portfolio project
Read Markdown files from the usability evaluation knowledge area
Read Markdown files from the dashboard and UX patterns knowledge area
Run a quality gate verification against a design deliverable
Search the ZtotheZ Design Engineering knowledge base using semantic and keyword search
Validate a design deliverable against the ZtotheZ Design Engineering specification
Validate an information design contract against the ZtotheZ Design Engineering specification
Validate an interface trust contract against the ZtotheZ Design Engineering specification
Validate a product design brief against the ZtotheZ Design Engineering specification
Validate a product contract against the ZtotheZ Design Engineering specification
Verify a UI runtime against interface trust and design contracts using browser automation
Parameter descriptions are generic and lack constraints. 'Path to the product design brief file (YAML or JSON)' does not specify: required format, relative vs absolute path, validation rules, or error cases. LLMs cannot validate input before calling.
Tool descriptions are 35-50 characters, well below the 50-200 char baseline for LLM optimization. 'Validate a product design brief against the ZtotheZ Design Engineering specification' lacks WHEN to use it, what happens on failure, and how it differs from similar validation tools.
No error handling guidance. Tools return READ_ONLY risk but no documentation of what errors are possible, whether they are retryable, or what the LLM should do on failure. No recovery paths documented.