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.
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/.claude/skills/README.md +6 -8
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/.gitignore +0 -17
- mapify_cli-3.3.0/PKG-INFO +134 -0
- mapify_cli-3.3.0/README.md +102 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/pyproject.toml +1 -1
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/__init__.py +82 -203
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/dependency_graph.py +116 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/schemas.py +3 -197
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/CLAUDE.md +1 -2
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/actor.md +75 -158
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/debate-arbiter.md +1 -1
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/documentation-reviewer.md +0 -25
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/evaluator.md +10 -33
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/final-verifier.md +8 -8
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/monitor.md +104 -100
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/predictor.md +92 -161
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/reflector.md +31 -93
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/research-agent.md +1 -22
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/task-decomposer.md +39 -46
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-check.md +8 -8
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-debate.md +107 -88
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-debug.md +2 -10
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-efficient.md +218 -76
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-fast.md +5 -7
- mapify_cli-3.3.0/src/mapify_cli/templates/commands/map-learn.md +246 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-plan.md +59 -18
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/commands/map-release.md +11 -31
- mapify_cli-3.3.0/src/mapify_cli/templates/commands/map-resume.md +454 -0
- mapify_cli-3.3.0/src/mapify_cli/templates/commands/map-review.md +307 -0
- mapify_cli-3.3.0/src/mapify_cli/templates/hooks/block-dangerous.sh +173 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/block-secrets.py +43 -13
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/post-edit-reminder.py +20 -4
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/ralph-context-pruner.py +6 -2
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/ralph-iteration-logger.py +1 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/safety-guardrails.py +26 -17
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/workflow-context-injector.py +31 -5
- mapify_cli-3.3.0/src/mapify_cli/templates/hooks/workflow-gate.py +269 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/scripts/diagnostics.py +7 -1
- mapify_cli-3.3.0/src/mapify_cli/templates/map/scripts/map_orchestrator.py +1207 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/scripts/map_step_runner.py +94 -6
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/mcp-usage-examples.md +2 -29
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/step-state-schema.md +7 -9
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/workflow-state-schema.md +11 -14
- mapify_cli-3.3.0/src/mapify_cli/templates/settings.json +118 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/README.md +6 -8
- mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-cli-reference/SKILL.md +124 -0
- mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-cli-reference/scripts/check-command.sh +117 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/SKILL.md +72 -9
- mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-planning/scripts/get-plan-path.sh +40 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/scripts/init-session.sh +14 -9
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/SKILL.md +147 -195
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-workflows-guide/resources/agent-architecture.md +56 -36
- {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
- {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
- {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
- {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
- {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
- mapify_cli-3.3.0/src/mapify_cli/templates/skills/map-workflows-guide/scripts/validate-workflow-choice.py +159 -0
- mapify_cli-3.3.0/src/mapify_cli/templates/skills/skill-rules.json +75 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/workflow-rules.json +27 -28
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/verification_recorder.py +11 -8
- mapify_cli-3.1.0/PKG-INFO +0 -33
- mapify_cli-3.1.0/README.md +0 -1
- mapify_cli-3.1.0/src/mapify_cli/contradiction_detector.py +0 -735
- mapify_cli-3.1.0/src/mapify_cli/entity_extractor.py +0 -877
- mapify_cli-3.1.0/src/mapify_cli/graph_query.py +0 -787
- mapify_cli-3.1.0/src/mapify_cli/relationship_detector.py +0 -771
- mapify_cli-3.1.0/src/mapify_cli/templates/agents/curator.md +0 -1296
- mapify_cli-3.1.0/src/mapify_cli/templates/commands/map-learn.md +0 -472
- mapify_cli-3.1.0/src/mapify_cli/templates/commands/map-resume.md +0 -423
- mapify_cli-3.1.0/src/mapify_cli/templates/commands/map-review.md +0 -180
- mapify_cli-3.1.0/src/mapify_cli/templates/hooks/block-dangerous.sh +0 -114
- mapify_cli-3.1.0/src/mapify_cli/templates/hooks/workflow-gate.py +0 -169
- mapify_cli-3.1.0/src/mapify_cli/templates/map/scripts/map_orchestrator.py +0 -586
- mapify_cli-3.1.0/src/mapify_cli/templates/settings.hooks.json +0 -74
- mapify_cli-3.1.0/src/mapify_cli/templates/settings.json +0 -38
- mapify_cli-3.1.0/src/mapify_cli/templates/skills/map-cli-reference/SKILL.md +0 -142
- mapify_cli-3.1.0/src/mapify_cli/templates/skills/map-planning/scripts/get-plan-path.sh +0 -35
- mapify_cli-3.1.0/src/mapify_cli/templates/skills/map-workflows-guide/resources/playbook-system.md +0 -301
- mapify_cli-3.1.0/src/mapify_cli/templates/skills/skill-rules.json +0 -29
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/intent_detector.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/ralph_state.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/repo_insight.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/agents/synthesizer.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/end-of-turn.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/hooks/improve-prompt.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/analyze.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/common.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/go.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/python.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/rust.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/map/static-analysis/handlers/typescript.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/ralph-loop-config.json +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/bash-guidelines.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/decomposition-examples.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/references/escalation-matrix.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/scripts/check-complete.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/scripts/show-focus.sh +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/findings.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/iteration_history.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/progress.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/templates/skills/map-planning/templates/task_plan.md +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/tools/__init__.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/tools/validate_dependencies.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/workflow_finalizer.py +0 -0
- {mapify_cli-3.1.0 → mapify_cli-3.3.0}/src/mapify_cli/workflow_logger.py +0 -0
- {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 (
|
|
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-
|
|
56
|
-
- `
|
|
57
|
-
- `
|
|
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
|
|
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.
|
|
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
|
+
[](https://pypi.org/project/mapify-cli/)
|
|
36
|
+
[](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
|
+
[](https://pypi.org/project/mapify-cli/)
|
|
4
|
+
[](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.
|