A semantic search and planning system for managing markdown-based knowledge bases with file watching, embedding-based retrieval, and nREPL integration
Winze provides 6 tools with visible schemas and descriptions, but quality is inconsistent. All tools have descriptions (10-100 chars, mostly adequate) and input schemas with typed parameters. However, descriptions are terse and lack actionable context for LLM selection. Parameter descriptions are minimal or absent. No output schemas documented. Error handling guidance is absent. Tool naming uses hyphens (search-plans, list-plans) rather than underscores, deviating from Arcade baseline conventions. No tool annotations (readOnlyHint/destructiveHint) despite clear risk profiles. The index-plans tool is destructive (WRITE risk) but has no confirmation pattern or dry-run option.
Manual reconciliation/reindex trigger — returns formatted markdown.
List all indexed file paths — returns formatted markdown.
Health check — returns formatted markdown.
Recently modified files — returns formatted markdown.
Group lookup with cross-references — returns formatted markdown.
Semantic search — returns formatted markdown matching Python server output.
No output schemas documented. LLMs cannot predict response structure or plan downstream tool calls. All 6 tools lack documented return types.
Destructive tool (index-plans) lacks confirmation pattern or dry-run option. Agents can trigger reindex/reset without safeguards, risking data loss.
Tool naming uses hyphens (search-plans, list-plans) instead of underscores (search_plans, list_plans). Deviates from Arcade baseline (90% of A+ tools use verb_noun with underscores). Inconsistent with MCP conventions.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 41 | <=2025-11-25 | v2 |
No tool annotations (readOnlyHint/destructiveHint/idempotentHint). Risk profiles are declared in metadata but not in tool definitions. Clients cannot infer safety properties.
Parameter descriptions are minimal or absent. E.g., 'detail' param has description 'Detail level: :files, :summary, or :full (default)' but does not explain WHEN to use each level or what data each returns.