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.4.1.tar.gz (314.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.4.1-py3-none-any.whl (367.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mapify_cli-3.4.1.tar.gz
  • Upload date:
  • Size: 314.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.4.1.tar.gz
Algorithm Hash digest
SHA256 3457dc048340025647b2751a3858bec8c531acfae0d4338947b4ffc6ae586932
MD5 72e444f29e570c14aabc379bf1a67c2b
BLAKE2b-256 b0b2e34e15d8a732b20929369e3aae54ce83ef5dde606d7d433c849e0272e7db

See more details on using hashes here.

Provenance

The following attestation bundles were made for mapify_cli-3.4.1.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.4.1-py3-none-any.whl.

File metadata

  • Download URL: mapify_cli-3.4.1-py3-none-any.whl
  • Upload date:
  • Size: 367.3 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.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 34389ca1268312013d5872cdc738aa7d10d2153725e31dd7bf015d3fed5c1ac6
MD5 7061b828526f6d0a50172ca46c07dafd
BLAKE2b-256 a7badcf3f9bca5f72c43867638ced295aceaf2f196e49e7502e6dd2a71d54f35

See more details on using hashes here.

Provenance

The following attestation bundles were made for mapify_cli-3.4.1-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