map-cli-reference
Use when encountering mapify CLI command errors (no such option, no such command, parameter not found) or need quick reference for correct command syntax. Provides mapify playbook/validate command corrections and common mistake patterns.
When & Why to Use This Skill
The map-cli-reference skill is a specialized technical guide designed to help developers navigate and troubleshoot the Mapify CLI and MCP (Model Context Protocol) environment. It serves as a real-time reference for command syntax, parameter validation, and error correction, specifically addressing the transition to v4.0+ workflows. By providing clear solutions for deprecated commands and integration patterns for Curator and Reflector agents, it streamlines the development process and reduces downtime caused by configuration or syntax errors.
Use Cases
- Troubleshooting CLI Errors: Quickly resolve common 'no such command' or 'parameter not found' errors when executing mapify commands or validate graph tasks.
- Pattern Retrieval via mem0 MCP: Perform tiered searches across branch, project, and organization namespaces to find specific architectural or security patterns.
- Dependency Graph Validation: Use the 'mapify validate graph' command to check task plans for structural integrity and visualize dependencies before deployment.
- Workflow Migration: Transition from deprecated 'playbook' subcommands to the modern Curator agent workflow for storing, searching, and archiving patterns.
- System Configuration Checks: Perform environment health checks and agent upgrades using 'mapify check' and 'mapify upgrade' to ensure the local setup is optimized.
name: map-cli-reference description: Use when encountering mapify CLI or MCP usage errors (no such command, no such option, parameter not found). Provides mem0 MCP and validate command corrections with common mistake patterns.
MAP CLI Quick Reference
Note (v4.0+): Pattern storage and retrieval uses mem0 MCP (tiered namespaces). Legacy playbook subcommands are not the source of truth for patterns.
Fast lookup for commands, parameters, and common error corrections.
For comprehensive documentation, see:
Quick Command Index
Pattern Search (mem0 MCP)
# Tiered search across namespaces (branch → project → org)
mcp__mem0__map_tiered_search(query="JWT authentication", limit=5)
# Use section_filter when you know the category
mcp__mem0__map_tiered_search(query="input validation", section_filter="SECURITY_PATTERNS", limit=10)
Validate Commands
# Validate dependency graph
mapify validate graph task_plan.json
echo '{"subtasks":[...]}' | mapify validate graph
# Visualize dependencies
mapify validate graph task_plan.json --visualize
# Strict mode (fail on warnings)
mapify validate graph task_plan.json --strict
Root Commands
# Initialize project
mapify init my-project
mapify init . --mcp essential --force
# System checks
mapify check
mapify check --debug
# Upgrade agents
mapify upgrade
Common Errors & Corrections
Error 1: Using Deprecated Playbook Commands
Issue: Error: No such command 'playbook' or docs/examples mention mapify playbook ...
Solution:
- For pattern retrieval: use
mcp__mem0__map_tiered_search - For pattern writes: use
Task(subagent_type="curator", ...)
Error 2: MCP Tool Not Available
Issue: mem0 calls return empty results or tool invocation fails.
Solution:
- Verify mem0 MCP is configured and enabled in
.claude/mcp_config.json(or Claude settings) - Confirm the org/project/branch namespaces match your workflow conventions
Error 3: Wrong Approach (CRITICAL)
❌ WRONG: Writing patterns directly (ad-hoc scripts / manual storage)
✅ CORRECT: Use Curator agent:
Task(subagent_type="curator", ...)
Curator must:
- Search duplicates first via
mcp__mem0__map_tiered_search - Store new patterns via
mcp__mem0__map_add_pattern - Archive outdated patterns via
mcp__mem0__map_archive_pattern
Integration with MAP Workflows (v4.0+)
Curator Agent
Role: Stores patterns in mem0 MCP
Workflow:
- Curator analyzes reflector insights
- Checks for duplicates via
mcp__mem0__map_tiered_search - Stores new patterns via
mcp__mem0__map_add_pattern - Archives outdated patterns via
mcp__mem0__map_archive_pattern
Reflector Agent
Role: Searches for existing patterns before extracting new ones
MCP tool used:
mcp__mem0__map_tiered_search(query="error handling", limit=5)
Exit Codes (validate graph)
- 0: Valid graph (no critical errors)
- 1: Invalid graph (critical errors or warnings with
--strict) - 2: Malformed input (invalid JSON)
See Also
Related Skills:
Source Code:
src/mapify_cli/__init__.py
Version: 1.1 Last Updated: 2026-01-15 Lines: ~200 (follows 500-line skill rule)