Skip to main content

MAP Framework installer - Modular Agentic Planner for Claude Code

Project description

MAP Framework for Claude Code

PyPI version Python 3.11+

Structured AI development workflows that replace ad-hoc prompting with plan → execute → validate loops.

Based on MAP cognitive architecture (Nature Communications, 2025) — 74% improvement in planning tasks.

Why MAP?

  • Structured workflows — 12 specialized agents instead of single-prompt chaos
  • Quality gates — automatic validation catches errors before they compound
  • 40-60% cost savings — prevents circular reasoning and scope creep
  • Learning system — captures patterns for reuse across projects

Quick Start

1. Install

uv tool install mapify-cli

# or with pip
pip install mapify-cli

2. Initialize (in your project)

cd your-project
mapify init

3. Start Claude Code and run your first workflow

claude
/map-efficient implement user authentication with JWT tokens

You'll know it's working when: Claude spawns specialized agents (TaskDecomposer → Actor → Monitor) with structured output instead of freeform responses.

Core Commands

Command Use For
/map-efficient Production features, refactoring, complex tasks (recommended)
/map-debug Bug fixes and debugging
/map-fast Small, low-risk changes
/map-debate Complex decisions with multi-variant synthesis
/map-review Pre-commit code review
/map-check Quality gates and verification
/map-plan Task decomposition without implementation
/map-release Package release workflow
/map-resume Resume interrupted workflows
/map-learn Extract lessons after workflow completion

Detailed usage and options →

How It Works

MAP orchestrates specialized agents through slash commands:

TaskDecomposer → breaks goal into subtasks
     ↓
   Actor → generates code
     ↓
  Monitor → validates quality (loop if needed)
     ↓
 Predictor → analyzes impact (for risky changes)

The orchestration lives in .claude/commands/map-*.md prompts created by mapify init.

Architecture deep-dive →

Documentation

Guide Description
Installation All install methods, PATH setup, troubleshooting
Usage Guide Workflows, examples, cost optimization, playbook
Architecture Agents, MCP integration, customization

Trouble?

  • Command not found → Run mapify init in your project first
  • Agent errors → Check .claude/agents/ has all 12 .md files
  • More help →

Contributing

Improvements welcome: prompts for specific languages, new agents, CI/CD integrations.

License

MIT


MAP brings structure to AI-assisted development. Start with /map-efficient and see the difference.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mapify_cli-3.5.0.tar.gz (326.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mapify_cli-3.5.0-py3-none-any.whl (381.1 kB view details)

Uploaded Python 3

File details

Details for the file mapify_cli-3.5.0.tar.gz.

File metadata

  • Download URL: mapify_cli-3.5.0.tar.gz
  • Upload date:
  • Size: 326.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mapify_cli-3.5.0.tar.gz
Algorithm Hash digest
SHA256 46a8346132dd510c859b4a64ce6c831df54e415e63962c42e4a3abd3ac64c2df
MD5 4aa99928faf055c5c19a3caa89bef105
BLAKE2b-256 0b713025f436202f8a5136f5649648854d0c3a1e9169af3f3f552b11c32fc1c5

See more details on using hashes here.

Provenance

The following attestation bundles were made for mapify_cli-3.5.0.tar.gz:

Publisher: release.yml on azalio/map-framework

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mapify_cli-3.5.0-py3-none-any.whl.

File metadata

  • Download URL: mapify_cli-3.5.0-py3-none-any.whl
  • Upload date:
  • Size: 381.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mapify_cli-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d44a9ecce3dbe11a53fd0be345338c9b6e76b64de675c307bf2b0996b596e683
MD5 e677c2956feca1ccdc2700b8b40998f3
BLAKE2b-256 3f5d69dd40c720fa372f2ac59d04f8f1b05cf69d1c3a6e7a48436b94fa819c41

See more details on using hashes here.

Provenance

The following attestation bundles were made for mapify_cli-3.5.0-py3-none-any.whl:

Publisher: release.yml on azalio/map-framework

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page