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.0.tar.gz (314.2 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.0-py3-none-any.whl (367.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mapify_cli-3.4.0.tar.gz
  • Upload date:
  • Size: 314.2 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.0.tar.gz
Algorithm Hash digest
SHA256 30600c57d717b1a6a6972a7697d802edf18677794bb0d6815fe75d9b50057a9a
MD5 2af24227537b5cc685a3f1c2e7d7c690
BLAKE2b-256 3a2005b4fbf0dd6eabe4a80a8846726c3a0f8d13be3e3e5ab7ebbad039d57ecc

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: mapify_cli-3.4.0-py3-none-any.whl
  • Upload date:
  • Size: 367.2 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e0d3ed137a7d9ed155a77c8cd866672bff1393467b0dfc245fd0992b40bfb19a
MD5 ea9ffbc6a70c3abe21918f82ea8dd1d4
BLAKE2b-256 371c1e95c60c71f6ee1ae91d25dfad57b039590095d9427d246ed9b4394d36b9

See more details on using hashes here.

Provenance

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