mapify-cli 3.1.0__tar.gz → 3.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/.claude/skills/README.md +6 -8
  2. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/.gitignore +0 -17
  3. mapify_cli-3.3.0/PKG-INFO +134 -0
  4. mapify_cli-3.3.0/README.md +102 -0
  5. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/pyproject.toml +1 -1
  6. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/__init__.py +82 -203
  7. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/dependency_graph.py +116 -0
  8. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/schemas.py +3 -197
  9. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/CLAUDE.md +1 -2
  10. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/actor.md +75 -158
  11. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/debate-arbiter.md +1 -1
  12. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/documentation-reviewer.md +0 -25
  13. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/evaluator.md +10 -33
  14. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/final-verifier.md +8 -8
  15. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/monitor.md +104 -100
  16. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/predictor.md +92 -161
  17. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/reflector.md +31 -93
  18. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/research-agent.md +1 -22
  19. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/task-decomposer.md +39 -46
  20. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-check.md +8 -8
  21. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-debate.md +107 -88
  22. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-debug.md +2 -10
  23. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-efficient.md +218 -76
  24. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-fast.md +5 -7
  25. mapify_cli-3.3.0/src/mapify_cli/templates/commands/map-learn.md +246 -0
  26. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-plan.md +59 -18
  27. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-release.md +11 -31
  28. mapify_cli-3.3.0/src/mapify_cli/templates/commands/map-resume.md +454 -0
  29. mapify_cli-3.3.0/src/mapify_cli/templates/commands/map-review.md +307 -0
  30. mapify_cli-3.3.0/src/mapify_cli/templates/hooks/block-dangerous.sh +173 -0
  31. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/block-secrets.py +43 -13
  32. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/post-edit-reminder.py +20 -4
  33. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/ralph-context-pruner.py +6 -2
  34. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/ralph-iteration-logger.py +1 -0
  35. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/safety-guardrails.py +26 -17
  36. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/workflow-context-injector.py +31 -5
  37. mapify_cli-3.3.0/src/mapify_cli/templates/hooks/workflow-gate.py +269 -0
  38. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/scripts/diagnostics.py +7 -1
  39. mapify_cli-3.3.0/src/mapify_cli/templates/map/scripts/map_orchestrator.py +1207 -0
  40. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/scripts/map_step_runner.py +94 -6
  41. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/mcp-usage-examples.md +2 -29
  42. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/step-state-schema.md +7 -9
  43. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/workflow-state-schema.md +11 -14
  44. mapify_cli-3.3.0/src/mapify_cli/templates/settings.json +118 -0
  45. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/README.md +6 -8
  46. mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-cli-reference/SKILL.md +124 -0
  47. mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-cli-reference/scripts/check-command.sh +117 -0
  48. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/SKILL.md +72 -9
  49. mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-planning/scripts/get-plan-path.sh +40 -0
  50. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/scripts/init-session.sh +14 -9
  51. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/SKILL.md +147 -195
  52. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/agent-architecture.md +56 -36
  53. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/map-debug-deep-dive.md +2 -5
  54. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/map-efficient-deep-dive.md +40 -41
  55. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/map-fast-deep-dive.md +16 -17
  56. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/map-feature-deep-dive.md +15 -17
  57. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/map-refactor-deep-dive.md +4 -5
  58. mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-workflows-guide/scripts/validate-workflow-choice.py +159 -0
  59. mapify_cli-3.3.0/src/mapify_cli/templates/skills/skill-rules.json +75 -0
  60. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/workflow-rules.json +27 -28
  61. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/verification_recorder.py +11 -8
  62. mapify_cli-3.1.0/PKG-INFO +0 -33
  63. mapify_cli-3.1.0/README.md +0 -1
  64. mapify_cli-3.1.0/src/mapify_cli/contradiction_detector.py +0 -735
  65. mapify_cli-3.1.0/src/mapify_cli/entity_extractor.py +0 -877
  66. mapify_cli-3.1.0/src/mapify_cli/graph_query.py +0 -787
  67. mapify_cli-3.1.0/src/mapify_cli/relationship_detector.py +0 -771
  68. mapify_cli-3.1.0/src/mapify_cli/templates/agents/curator.md +0 -1296
  69. mapify_cli-3.1.0/src/mapify_cli/templates/commands/map-learn.md +0 -472
  70. mapify_cli-3.1.0/src/mapify_cli/templates/commands/map-resume.md +0 -423
  71. mapify_cli-3.1.0/src/mapify_cli/templates/commands/map-review.md +0 -180
  72. mapify_cli-3.1.0/src/mapify_cli/templates/hooks/block-dangerous.sh +0 -114
  73. mapify_cli-3.1.0/src/mapify_cli/templates/hooks/workflow-gate.py +0 -169
  74. mapify_cli-3.1.0/src/mapify_cli/templates/map/scripts/map_orchestrator.py +0 -586
  75. mapify_cli-3.1.0/src/mapify_cli/templates/settings.hooks.json +0 -74
  76. mapify_cli-3.1.0/src/mapify_cli/templates/settings.json +0 -38
  77. mapify_cli-3.1.0/src/mapify_cli/templates/skills/map-cli-reference/SKILL.md +0 -142
  78. mapify_cli-3.1.0/src/mapify_cli/templates/skills/map-planning/scripts/get-plan-path.sh +0 -35
  79. mapify_cli-3.1.0/src/mapify_cli/templates/skills/map-workflows-guide/resources/playbook-system.md +0 -301
  80. mapify_cli-3.1.0/src/mapify_cli/templates/skills/skill-rules.json +0 -29
  81. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/intent_detector.py +0 -0
  82. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/ralph_state.py +0 -0
  83. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/repo_insight.py +0 -0
  84. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/synthesizer.md +0 -0
  85. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/end-of-turn.sh +0 -0
  86. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/improve-prompt.py +0 -0
  87. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/analyze.sh +0 -0
  88. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/common.sh +0 -0
  89. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/go.sh +0 -0
  90. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/python.sh +0 -0
  91. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/rust.sh +0 -0
  92. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/typescript.sh +0 -0
  93. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/ralph-loop-config.json +0 -0
  94. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/bash-guidelines.md +0 -0
  95. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/decomposition-examples.md +0 -0
  96. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/escalation-matrix.md +0 -0
  97. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/scripts/check-complete.sh +0 -0
  98. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/scripts/show-focus.sh +0 -0
  99. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/findings.md +0 -0
  100. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/iteration_history.md +0 -0
  101. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/progress.md +0 -0
  102. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/task_plan.md +0 -0
  103. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/tools/__init__.py +0 -0
  104. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/tools/validate_dependencies.py +0 -0
  105. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/workflow_finalizer.py +0 -0
  106. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/workflow_logger.py +0 -0
  107. {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/workflow_state.py +0 -0
@@ -34,7 +34,7 @@ Skills provide specialized guidance without executing code. They help users unde
34
34
 
35
35
  **Content:**
36
36
  - Quick decision tree (5 questions)
37
- - Workflow comparison matrix (5 workflows)
37
+ - Workflow comparison matrix (4 implemented + 2 planned)
38
38
  - Detailed workflow descriptions
39
39
  - Agent architecture overview
40
40
  - 8 deep-dive resource files
@@ -50,11 +50,10 @@ MAP: [Shows decision tree and comparison matrix]
50
50
  **Resources available:**
51
51
  - `map-fast-deep-dive.md` - When (not) to use /map-fast
52
52
  - `map-efficient-deep-dive.md` - Optimization strategies
53
- - `map-feature-deep-dive.md` - Full validation workflow
54
53
  - `map-debug-deep-dive.md` - Debugging techniques
55
- - `map-refactor-deep-dive.md` - Dependency analysis
56
- - `agent-architecture.md` - How 8 agents orchestrate
57
- - `playbook-system.md` - Knowledge storage and search
54
+ - `map-feature-deep-dive.md` - Full validation workflow (PLANNED)
55
+ - `map-refactor-deep-dive.md` - Dependency analysis (PLANNED)
56
+ - `agent-architecture.md` - How 12 agents orchestrate
58
57
 
59
58
  ---
60
59
 
@@ -124,7 +123,6 @@ Skills work seamlessly with the prompt improvement system:
124
123
  ├── map-debug-deep-dive.md
125
124
  ├── map-refactor-deep-dive.md
126
125
  ├── agent-architecture.md
127
- ├── playbook-system.md
128
126
  ```
129
127
 
130
128
  ---
@@ -154,12 +152,12 @@ Skills work seamlessly with the prompt improvement system:
154
152
 
155
153
  **Check:**
156
154
  1. `skill-rules.json` has correct triggers
157
- 2. `improve-prompt.py` hook is enabled in `settings.hooks.json`
155
+ 2. `improve-prompt.py` hook is enabled in `.claude/settings.json`
158
156
  3. Hook processes UserPromptSubmit events
159
157
 
160
158
  **Fix:**
161
159
  - Update trigger patterns in `skill-rules.json`
162
- - Verify hook configuration in `.claude/settings.hooks.json`
160
+ - Verify hook configuration in `.claude/settings.json`
163
161
 
164
162
  ### Skill content too long
165
163
 
@@ -27,15 +27,7 @@ wheels/
27
27
  data/
28
28
  htmlcov/
29
29
 
30
- # ACE Playbook - user-specific data
31
30
  .claude/embeddings_cache/
32
- # LEGACY: playbook.json entries for migration support (ignore old format files)
33
- .claude/playbook.json
34
- .claude/playbook.json.backup.*
35
- # Current format: SQLite database
36
- .claude/playbook.db
37
- .claude/playbook.db-shm
38
- .claude/playbook.db-wal
39
31
  .claude/mcp_config.json
40
32
  .claude/settings.local.json
41
33
 
@@ -66,15 +58,6 @@ docs/claude-code-infrastructure-showcase
66
58
  docs/claude-code-subagents
67
59
 
68
60
 
69
- # Curator temporary files
70
- .claude/curator_delta_operations.json
71
- .claude/curator_integration_report.json
72
- .claude/curator_operations.json
73
- .claude/*_integration_report.json
74
- .claude/apply_*_deltas.py
75
- .claude/insert_*_bullets.sql
76
- curator_operations*.json
77
- curator_final_report.json
78
61
  docs/claude-code-prompt-improver
79
62
 
80
63
  # macOS system files
@@ -0,0 +1,134 @@
1
+ Metadata-Version: 2.4
2
+ Name: mapify-cli
3
+ Version: 3.3.0
4
+ Summary: MAP Framework installer - Modular Agentic Planner for Claude Code
5
+ Project-URL: Homepage, https://github.com/azalio/map-framework
6
+ Project-URL: Repository, https://github.com/azalio/map-framework.git
7
+ Project-URL: Issues, https://github.com/azalio/map-framework/issues
8
+ Author: MAP Framework Contributors
9
+ Requires-Python: >=3.11
10
+ Requires-Dist: httpx>=0.25.0
11
+ Requires-Dist: platformdirs>=4.0.0
12
+ Requires-Dist: questionary>=2.0.0
13
+ Requires-Dist: readchar>=4.0.0
14
+ Requires-Dist: rich>=13.0.0
15
+ Requires-Dist: typer>=0.9.0
16
+ Provides-Extra: dev
17
+ Requires-Dist: black>=23.0.0; extra == 'dev'
18
+ Requires-Dist: mypy>=1.0.0; extra == 'dev'
19
+ Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
20
+ Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
21
+ Requires-Dist: pytest>=7.0.0; extra == 'dev'
22
+ Requires-Dist: pyyaml>=6.0.0; extra == 'dev'
23
+ Requires-Dist: ruff>=0.1.0; extra == 'dev'
24
+ Provides-Extra: ssl
25
+ Requires-Dist: truststore>=0.9.0; extra == 'ssl'
26
+ Provides-Extra: test
27
+ Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
28
+ Requires-Dist: pytest-mock>=3.10.0; extra == 'test'
29
+ Requires-Dist: pytest>=7.0.0; extra == 'test'
30
+ Requires-Dist: pyyaml>=6.0.0; extra == 'test'
31
+ Description-Content-Type: text/markdown
32
+
33
+ # MAP Framework for Claude Code
34
+
35
+ [![PyPI version](https://badge.fury.io/py/mapify-cli.svg)](https://pypi.org/project/mapify-cli/)
36
+ [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
37
+
38
+ > Structured AI development workflows that replace ad-hoc prompting with **plan → execute → validate** loops.
39
+
40
+ Based on [MAP cognitive architecture](https://github.com/Shanka123/MAP) (Nature Communications, 2025) — 74% improvement in planning tasks.
41
+
42
+ ## Why MAP?
43
+
44
+ - **Structured workflows** — 12 specialized agents instead of single-prompt chaos
45
+ - **Quality gates** — automatic validation catches errors before they compound
46
+ - **40-60% cost savings** — prevents circular reasoning and scope creep
47
+ - **Learning system** — captures patterns for reuse across projects
48
+
49
+ ## Quick Start
50
+
51
+ **1. Install**
52
+ ```bash
53
+ uv tool install mapify-cli
54
+
55
+ # or with pip
56
+ pip install mapify-cli
57
+ ```
58
+
59
+ **2. Initialize** (in your project)
60
+ ```bash
61
+ cd your-project
62
+ mapify init
63
+ ```
64
+
65
+ **3. Start Claude Code and run your first workflow**
66
+ ```bash
67
+ claude
68
+ ```
69
+ ```
70
+ /map-efficient implement user authentication with JWT tokens
71
+ ```
72
+
73
+ **You'll know it's working when:** Claude spawns specialized agents (TaskDecomposer → Actor → Monitor) with structured output instead of freeform responses.
74
+
75
+ ## Core Commands
76
+
77
+ | Command | Use For |
78
+ |---------|---------|
79
+ | `/map-efficient` | Production features, refactoring, complex tasks (recommended) |
80
+ | `/map-debug` | Bug fixes and debugging |
81
+ | `/map-fast` | Small, low-risk changes |
82
+ | `/map-debate` | Complex decisions with multi-variant synthesis |
83
+ | `/map-review` | Pre-commit code review |
84
+ | `/map-check` | Quality gates and verification |
85
+ | `/map-plan` | Task decomposition without implementation |
86
+ | `/map-release` | Package release workflow |
87
+ | `/map-resume` | Resume interrupted workflows |
88
+ | `/map-learn` | Extract lessons after workflow completion |
89
+
90
+ [Detailed usage and options →](docs/USAGE.md)
91
+
92
+ ## How It Works
93
+
94
+ MAP orchestrates specialized agents through slash commands:
95
+
96
+ ```
97
+ TaskDecomposer → breaks goal into subtasks
98
+
99
+ Actor → generates code
100
+
101
+ Monitor → validates quality (loop if needed)
102
+
103
+ Predictor → analyzes impact (for risky changes)
104
+ ```
105
+
106
+ The orchestration lives in `.claude/commands/map-*.md` prompts created by `mapify init`.
107
+
108
+ [Architecture deep-dive →](docs/ARCHITECTURE.md)
109
+
110
+ ## Documentation
111
+
112
+ | Guide | Description |
113
+ |-------|-------------|
114
+ | [Installation](docs/INSTALL.md) | All install methods, PATH setup, troubleshooting |
115
+ | [Usage Guide](docs/USAGE.md) | Workflows, examples, cost optimization, playbook |
116
+ | [Architecture](docs/ARCHITECTURE.md) | Agents, MCP integration, customization |
117
+
118
+ ## Trouble?
119
+
120
+ - **Command not found** → Run `mapify init` in your project first
121
+ - **Agent errors** → Check `.claude/agents/` has all 12 `.md` files
122
+ - [More help →](docs/INSTALL.md#troubleshooting)
123
+
124
+ ## Contributing
125
+
126
+ Improvements welcome: prompts for specific languages, new agents, CI/CD integrations.
127
+
128
+ ## License
129
+
130
+ MIT
131
+
132
+ ---
133
+
134
+ **MAP brings structure to AI-assisted development.** Start with `/map-efficient` and see the difference.
@@ -0,0 +1,102 @@
1
+ # MAP Framework for Claude Code
2
+
3
+ [![PyPI version](https://badge.fury.io/py/mapify-cli.svg)](https://pypi.org/project/mapify-cli/)
4
+ [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
5
+
6
+ > Structured AI development workflows that replace ad-hoc prompting with **plan → execute → validate** loops.
7
+
8
+ Based on [MAP cognitive architecture](https://github.com/Shanka123/MAP) (Nature Communications, 2025) — 74% improvement in planning tasks.
9
+
10
+ ## Why MAP?
11
+
12
+ - **Structured workflows** — 12 specialized agents instead of single-prompt chaos
13
+ - **Quality gates** — automatic validation catches errors before they compound
14
+ - **40-60% cost savings** — prevents circular reasoning and scope creep
15
+ - **Learning system** — captures patterns for reuse across projects
16
+
17
+ ## Quick Start
18
+
19
+ **1. Install**
20
+ ```bash
21
+ uv tool install mapify-cli
22
+
23
+ # or with pip
24
+ pip install mapify-cli
25
+ ```
26
+
27
+ **2. Initialize** (in your project)
28
+ ```bash
29
+ cd your-project
30
+ mapify init
31
+ ```
32
+
33
+ **3. Start Claude Code and run your first workflow**
34
+ ```bash
35
+ claude
36
+ ```
37
+ ```
38
+ /map-efficient implement user authentication with JWT tokens
39
+ ```
40
+
41
+ **You'll know it's working when:** Claude spawns specialized agents (TaskDecomposer → Actor → Monitor) with structured output instead of freeform responses.
42
+
43
+ ## Core Commands
44
+
45
+ | Command | Use For |
46
+ |---------|---------|
47
+ | `/map-efficient` | Production features, refactoring, complex tasks (recommended) |
48
+ | `/map-debug` | Bug fixes and debugging |
49
+ | `/map-fast` | Small, low-risk changes |
50
+ | `/map-debate` | Complex decisions with multi-variant synthesis |
51
+ | `/map-review` | Pre-commit code review |
52
+ | `/map-check` | Quality gates and verification |
53
+ | `/map-plan` | Task decomposition without implementation |
54
+ | `/map-release` | Package release workflow |
55
+ | `/map-resume` | Resume interrupted workflows |
56
+ | `/map-learn` | Extract lessons after workflow completion |
57
+
58
+ [Detailed usage and options →](docs/USAGE.md)
59
+
60
+ ## How It Works
61
+
62
+ MAP orchestrates specialized agents through slash commands:
63
+
64
+ ```
65
+ TaskDecomposer → breaks goal into subtasks
66
+
67
+ Actor → generates code
68
+
69
+ Monitor → validates quality (loop if needed)
70
+
71
+ Predictor → analyzes impact (for risky changes)
72
+ ```
73
+
74
+ The orchestration lives in `.claude/commands/map-*.md` prompts created by `mapify init`.
75
+
76
+ [Architecture deep-dive →](docs/ARCHITECTURE.md)
77
+
78
+ ## Documentation
79
+
80
+ | Guide | Description |
81
+ |-------|-------------|
82
+ | [Installation](docs/INSTALL.md) | All install methods, PATH setup, troubleshooting |
83
+ | [Usage Guide](docs/USAGE.md) | Workflows, examples, cost optimization, playbook |
84
+ | [Architecture](docs/ARCHITECTURE.md) | Agents, MCP integration, customization |
85
+
86
+ ## Trouble?
87
+
88
+ - **Command not found** → Run `mapify init` in your project first
89
+ - **Agent errors** → Check `.claude/agents/` has all 12 `.md` files
90
+ - [More help →](docs/INSTALL.md#troubleshooting)
91
+
92
+ ## Contributing
93
+
94
+ Improvements welcome: prompts for specific languages, new agents, CI/CD integrations.
95
+
96
+ ## License
97
+
98
+ MIT
99
+
100
+ ---
101
+
102
+ **MAP brings structure to AI-assisted development.** Start with `/map-efficient` and see the difference.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "mapify-cli"
3
- version = "3.1.0"
3
+ version = "3.3.0"
4
4
  description = "MAP Framework installer - Modular Agentic Planner for Claude Code"
5
5
  authors = [{ name = "MAP Framework Contributors" }]
6
6
  readme = "README.md"