Portable long-term memory store for agents, exposed over MCP
Single tool 'memorybank_scan' has a basic description (71 chars) but lacks critical detail on when/why to use it. Input schema is minimal: only 'target' (string) with a 72-char description. No output schema documented. No error handling guidance, no parameter constraints (e.g., path validation, max depth), and no indication of side effects or prerequisites. The tool name uses verb_noun pattern correctly, but the description does not explain what 'memory markers' are, what findings are returned, or how to interpret the JSON. Baseline: A+ tools average 194 chars in description and 72 chars per param; this tool meets param length but falls short on description depth and output documentation.
Portable long-term memory store for agents, exposed over MCP. Returns JSON findings.
Output schema not documented. LLM cannot predict the structure of returned JSON findings (fields, types, nesting). Baseline: 100% of A+ tools document return types.
Description lacks WHEN/WHY context. 'Portable long-term memory store' is vague, does not explain what 'memory markers' are, what rules trigger findings (TODO/FIXME/XXX), or when an agent should call this vs. other scanning tools.
No input validation or constraints. 'target' parameter accepts any string; no guidance on valid paths, max depth, excluded directories, or error handling for invalid/inaccessible paths.
No error recovery guidance. If scan fails (permission denied, path not found, timeout), LLM receives no actionable error message or retry strategy.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Tool description does not state side effects or prerequisites. No mention of whether scan is read-only, whether it requires file system access, or whether it modifies state.