map-cli-reference

azalio's avatarfrom azalio

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.

⭐6stars🔀0forks📁View on GitHub🕐Updated Dec 19, 2025⬇️1downloads

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:

  1. Curator analyzes reflector insights
  2. Checks for duplicates via mcp__mem0__map_tiered_search
  3. Stores new patterns via mcp__mem0__map_add_pattern
  4. 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)