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

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/.claude/skills/README.md

@@ -34,7 +34,7 @@ Skills provide specialized guidance without executing code. They help users unde
 
 **Content:**
 - Quick decision tree (5 questions)
-- Workflow comparison matrix (5 workflows)
+- Workflow comparison matrix (4 implemented + 2 planned)
 - Detailed workflow descriptions
 - Agent architecture overview
 - 8 deep-dive resource files
@@ -50,10 +50,10 @@ MAP: [Shows decision tree and comparison matrix]
 **Resources available:**
 - `map-fast-deep-dive.md` - When (not) to use /map-fast
 - `map-efficient-deep-dive.md` - Optimization strategies
-- `map-feature-deep-dive.md` - Full validation workflow
 - `map-debug-deep-dive.md` - Debugging techniques
-- `map-refactor-deep-dive.md` - Dependency analysis
-- `agent-architecture.md` - How 8 agents orchestrate
+- `map-feature-deep-dive.md` - Full validation workflow (PLANNED)
+- `map-refactor-deep-dive.md` - Dependency analysis (PLANNED)
+- `agent-architecture.md` - How 12 agents orchestrate
 - `playbook-system.md` - Knowledge storage and search
 
 ---

mapify_cli-3.2.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: mapify-cli
+Version: 3.2.0
+Summary: MAP Framework installer - Modular Agentic Planner for Claude Code
+Project-URL: Homepage, https://github.com/azalio/map-framework
+Project-URL: Repository, https://github.com/azalio/map-framework.git
+Project-URL: Issues, https://github.com/azalio/map-framework/issues
+Author: MAP Framework Contributors
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: readchar>=4.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: ssl
+Requires-Dist: truststore>=0.9.0; extra == 'ssl'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: pyyaml>=6.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# MAP Framework for Claude Code
+
+[![PyPI version](https://badge.fury.io/py/mapify-cli.svg)](https://pypi.org/project/mapify-cli/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+> Structured AI development workflows that replace ad-hoc prompting with **plan → execute → validate** loops.
+
+Based on [MAP cognitive architecture](https://github.com/Shanka123/MAP) (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**
+```bash
+uv tool install mapify-cli
+
+# or with pip
+pip install mapify-cli
+```
+
+**2. Initialize** (in your project)
+```bash
+cd your-project
+mapify init
+```
+
+**3. Start Claude Code and run your first workflow**
+```bash
+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 →](docs/USAGE.md)
+
+## 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 →](docs/ARCHITECTURE.md)
+
+## Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Installation](docs/INSTALL.md) | All install methods, PATH setup, troubleshooting |
+| [Usage Guide](docs/USAGE.md) | Workflows, examples, cost optimization, playbook |
+| [Architecture](docs/ARCHITECTURE.md) | 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 →](docs/INSTALL.md#troubleshooting)
+
+## 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.

mapify_cli-3.2.0/README.md

@@ -0,0 +1,102 @@
+# MAP Framework for Claude Code
+
+[![PyPI version](https://badge.fury.io/py/mapify-cli.svg)](https://pypi.org/project/mapify-cli/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+> Structured AI development workflows that replace ad-hoc prompting with **plan → execute → validate** loops.
+
+Based on [MAP cognitive architecture](https://github.com/Shanka123/MAP) (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**
+```bash
+uv tool install mapify-cli
+
+# or with pip
+pip install mapify-cli
+```
+
+**2. Initialize** (in your project)
+```bash
+cd your-project
+mapify init
+```
+
+**3. Start Claude Code and run your first workflow**
+```bash
+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 →](docs/USAGE.md)
+
+## 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 →](docs/ARCHITECTURE.md)
+
+## Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Installation](docs/INSTALL.md) | All install methods, PATH setup, troubleshooting |
+| [Usage Guide](docs/USAGE.md) | Workflows, examples, cost optimization, playbook |
+| [Architecture](docs/ARCHITECTURE.md) | 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 →](docs/INSTALL.md#troubleshooting)
+
+## 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.

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mapify-cli"
-version = "3.1.0"
+version = "3.2.0"
 description = "MAP Framework installer - Modular Agentic Planner for Claude Code"
 authors = [{ name = "MAP Framework Contributors" }]
 readme = "README.md"

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/__init__.py

@@ -23,7 +23,7 @@ Or install globally:
     mapify check
 """
 
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 
 import copy
 import os
@@ -1195,38 +1195,39 @@ def configure_global_permissions() -> None:
     # Default permissions for read-only commands
     default_permissions = {
         "allow": [
-            "Bash(git status:*)",
-            "Bash(git log:*)",
-            "Bash(git diff:*)",
-            "Bash(git show:*)",
-            "Bash(git check-ignore:*)",
-            "Bash(git branch --show-current:*)",
-            "Bash(git branch -a:*)",
-            "Bash(git ls-files:*)",
-            "Bash(ls :*)",
-            "Bash(cat :*)",
-            "Bash(head :*)",
-            "Bash(tail :*)",
-            "Bash(wc :*)",
-            "Bash(grep :*)",
-            "Bash(find :*)",
-            "Bash(sort :*)",
-            "Bash(uniq :*)",
-            "Bash(jq :*)",
-            "Bash(which :*)",
-            "Bash(echo :*)",
-            "Bash(pwd:*)",
-            "Bash(whoami:*)",
-            "Bash(ruby -c :*)",
-            "Bash(go fmt /tmp/:*)",
-            "Bash(gofmt -l :*)",
-            "Bash(gofmt -d :*)",
-            "Bash(go vet :*)",
-            "Bash(go build:*)",
-            "Bash(go test -c:*)",
-            "Bash(go mod download:*)",
-            "Bash(go mod tidy:*)",
-            "Bash(chmod +x:*)",
+            "Bash(git status *)",
+            "Bash(git log *)",
+            "Bash(git diff *)",
+            "Bash(git show *)",
+            "Bash(git check-ignore *)",
+            "Bash(git branch --show-current *)",
+            "Bash(git branch -a *)",
+            "Bash(git rev-parse *)",
+            "Bash(git ls-files *)",
+            "Bash(ls *)",
+            "Bash(cat *)",
+            "Bash(head *)",
+            "Bash(tail *)",
+            "Bash(wc *)",
+            "Bash(grep *)",
+            "Bash(find *)",
+            "Bash(sort *)",
+            "Bash(uniq *)",
+            "Bash(jq *)",
+            "Bash(which *)",
+            "Bash(echo *)",
+            "Bash(pwd *)",
+            "Bash(whoami *)",
+            "Bash(ruby -c *)",
+            "Bash(go fmt /tmp/ *)",
+            "Bash(gofmt -l *)",
+            "Bash(gofmt -d *)",
+            "Bash(go vet *)",
+            "Bash(go build *)",
+            "Bash(go test -c *)",
+            "Bash(go mod download *)",
+            "Bash(go mod tidy *)",
+            "Bash(chmod +x *)",
             "Read(//Users/**)",
             "Read(//private/tmp/**)",
             "Glob(**)",
@@ -1292,19 +1293,19 @@ def create_or_merge_project_settings_local(project_path: Path) -> None:
             # SourceCraft MCP helpers (project-scoped)
             "mcp__sourcecraft__list_pull_request_comments",
             # Common safe Go workflows (project-scoped)
-            "Bash(go test:*)",
-            "Bash(go test -c:*)",
-            "Bash(go vet :*)",
-            "Bash(go build:*)",
-            "Bash(go mod download:*)",
-            "Bash(go mod tidy:*)",
-            "Bash(gofmt -l :*)",
-            "Bash(gofmt -d :*)",
+            "Bash(go test *)",
+            "Bash(go test -c *)",
+            "Bash(go vet *)",
+            "Bash(go build *)",
+            "Bash(go mod download *)",
+            "Bash(go mod tidy *)",
+            "Bash(gofmt -l *)",
+            "Bash(gofmt -d *)",
             # Common safe Make targets
             "Bash(make generate manifests)",
             "Bash(make manifests)",
             # Common git workflows
-            "Bash(git worktree add:*)",
+            "Bash(git worktree add *)",
             # Used by some test/dev scripts to produce temporary dev certs
             'Bash(openssl req -x509 -newkey rsa:512 -keyout /dev/null -out /dev/stdout -days 365 -nodes -subj "/CN=test" 2>/dev/null)',
         ],
@@ -1369,10 +1370,13 @@ def create_mcp_config(project_path: Path, mcp_servers: List[str]) -> None:
             "monitor": [],
             "predictor": [],
             "evaluator": [],
-            "orchestrator": [],
             "reflector": [],
             "curator": [],
             "documentation-reviewer": [],
+            "debate-arbiter": [],
+            "synthesizer": [],
+            "research-agent": [],
+            "final-verifier": [],
         },
         "workflow_settings": {
             "always_retrieve_knowledge": True,
@@ -1426,14 +1430,14 @@ def create_mcp_config(project_path: Path, mcp_servers: List[str]) -> None:
             "task-decomposer",
             "monitor",
             "evaluator",
-            "orchestrator",
             "reflector",
+            "debate-arbiter",
         ]:
             if agent in config["agent_mcp_mappings"]:
                 config["agent_mcp_mappings"][agent].append("sequential-thinking")
 
     if "claude-reviewer" in mcp_servers:
-        for agent in ["monitor", "evaluator", "orchestrator"]:
+        for agent in ["monitor", "evaluator", "final-verifier"]:
             if agent in config["agent_mcp_mappings"]:
                 config["agent_mcp_mappings"][agent].append("claude-reviewer")
 
@@ -2089,12 +2093,12 @@ def init(
     tracker.add("create-agents", "Create MAP agents")
     tracker.start("create-agents")
     create_agent_files(project_path, selected_mcp_servers)
-    tracker.complete("create-agents", "8 agents")
+    tracker.complete("create-agents", "12 agents")
 
     tracker.add("create-commands", "Create slash commands")
     tracker.start("create-commands")
     create_command_files(project_path)
-    tracker.complete("create-commands", "4 commands")
+    tracker.complete("create-commands", "10 commands")
 
     tracker.add("create-skills", "Create skills")
     tracker.start("create-skills")

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/entity_extractor.py

@@ -283,9 +283,14 @@ class EntityExtractor:
             "trunk-based": "trunk-based-development",
             "code-review": "code-review-process",
             "pair-programming": "pair-programming",
-            "map-feature": "map-feature-workflow",
+            "map-efficient": "map-efficient-workflow",
+            "map-fast": "map-fast-workflow",
             "map-debug": "map-debug-workflow",
-            "map-refactor": "map-refactor-workflow",
+            "map-debate": "map-debate-workflow",
+            "map-review": "map-review-workflow",
+            "map-plan": "map-plan-workflow",
+            "map-check": "map-check-workflow",
+            "map-release": "map-release-workflow",
             "agile": "agile-methodology",
             "scrum": "scrum-framework",
             "kanban": "kanban-method",

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/schemas.py

@@ -217,8 +217,8 @@ STATE_ARTIFACT_SCHEMA = {
     "properties": {
         "workflow": {
             "type": "string",
-            "description": "Type of MAP workflow (e.g., 'map-efficient', 'map-debug', 'map-feature')",
-            "examples": ["map-efficient", "map-debug", "map-feature", "map-refactor"],
+            "description": "Type of MAP workflow (e.g., 'map-efficient', 'map-debug', 'map-fast')",
+            "examples": ["map-efficient", "map-debug", "map-fast"],
         },
         "terminal_status": {
             "type": "string",

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/templates/agents/actor.md

@@ -271,15 +271,15 @@ Task(
 
 # Required Output Structure
 
-**CRITICAL: Actor outputs CODE AS TEXT, NOT file edits**
+**Actor applies code directly using Edit/Write tools.**
 
-You are a **proposal generator**, NOT a code executor. Your output is reviewed by Monitor before application.
+You are a code implementer. Read affected files, then apply changes with Edit/Write tools.
+Monitor will validate the written code afterward.
 
-- ✅ DO: Output complete code in markdown code blocks
-- ❌ NEVER: Use Edit, Write, or MultiEdit tools
-- ❌ NEVER: Modify files directly
-- 📋 WHY: workflow-gate.py will BLOCK Edit/Write until actor+monitor steps complete
-- 🔄 FLOW: You output → Monitor reviews → Orchestrator applies with Edit/Write
+- Use Edit tool for modifying existing files
+- Use Write tool for creating new files
+- Read files before editing to understand current state
+- Apply changes incrementally — one logical change per Edit call
 
 ---
 
@@ -422,7 +422,7 @@ Only include if changes affect:
 ## Pre-Submission Checklist
 
 ### Code Quality (Mandatory)
-- [ ] Follows {{standards_url}} style guide
+- [ ] Follows {{standards_doc}} style guide
 - [ ] Complete implementations (no placeholders, no `...`)
 - [ ] Self-documenting names (clear variables/functions)
 - [ ] Comments for complex logic only
@@ -502,6 +502,29 @@ When assessing performance impact, use these as default baselines unless project
 
 **Protocol**: Document rationale → Add TODO if needed → Proceed
 
+### Evidence File (Artifact-Gated Validation)
+
+After applying all code changes, write an evidence file so the orchestrator can verify this step ran. Use Bash (not Write tool) to create the file:
+
+```bash
+cat > .map/<branch>/evidence/actor_<subtask_id>.json << 'EVIDENCE'
+{
+  "phase": "ACTOR",
+  "subtask_id": "<subtask_id>",
+  "timestamp": "<ISO 8601 UTC>",
+  "summary": "<one-line description of what was implemented>",
+  "aag_contract": "<the AAG contract line>",
+  "files_changed": ["<list of modified file paths>"],
+  "status": "applied"
+}
+EVIDENCE
+```
+
+**Required fields** (orchestrator validates these): `phase`, `subtask_id`, `timestamp`.
+Other fields are informational but recommended for audit trail.
+
+**CRITICAL**: Without this file, `validate_step("2.3")` will reject the step.
+
 </Actor_Quality_v3_1>
 
 ---
@@ -670,8 +693,8 @@ output:
 - **Project**: {{project_name}}
 - **Language**: {{language}}
 - **Framework**: {{framework}}
-- **Standards**: {{standards_url}}
-- **Branch**: {{branch}}
+- **Standards**: {{standards_doc}}
+- **Branch**: {{branch_name}}
 - **Allowed Scope**: {{allowed_scope}}
 - **Related Files**: {{related_files}}
 
@@ -733,7 +756,7 @@ output:
 
 Follow this protocol exactly — do not infer "how seniors write" or add stylistic flourishes.
 
-1. **Style standard**: Use {{standards_url}}. If unavailable: Python→PEP8, JS/TS→Google Style, Go→gofmt, Rust→rustfmt.
+1. **Style standard**: Use {{standards_doc}}. If unavailable: Python→PEP8, JS/TS→Google Style, Go→gofmt, Rust→rustfmt.
 2. **Architecture**: Dependency injection where applicable. No global mutable state.
 3. **Naming**: Self-documenting (`user_count` not `n`, `is_valid` not `flag`). No abbreviations except industry-standard ones (URL, HTTP, ID).
 4. **Intent comments**: Add a one-line `# Intent: <why>` comment above any non-obvious logic block. Do NOT comment obvious code.

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/templates/agents/debate-arbiter.md

@@ -3,7 +3,7 @@ name: debate-arbiter
 description: Cross-evaluates Actor variants with explicit reasoning and synthesizes optimal solution (MAP Debate)
 model: opus
 version: 1.0.0
-last_updated: 2025-01-08
+last_updated: 2026-02-14
 ---
 
 # QUICK REFERENCE (Read First)

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/templates/agents/documentation-reviewer.md

@@ -444,7 +444,7 @@ mcp__deepwiki__ask_question(
 # 4. Check historical patterns (if mem0 available)
 mcp__mem0__map_tiered_search(
     query="CRD installation documentation patterns",
-    top_k=5,
+    limit=5,
     similarity_threshold=0.7
 )
 ```

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/templates/agents/final-verifier.md

@@ -18,36 +18,36 @@ You catch premature completion and hallucinated success.
 
 | Data | Source | How to Read |
 |------|--------|-------------|
-| Original Goal | `.map/task_plan_<branch>.md` | Section "## Goal" or first paragraph |
-| Acceptance Criteria | `.map/task_plan_<branch>.md` | Section "## Acceptance Criteria" (table) |
-| Completed Subtasks | `.map/progress_<branch>.md` | Checkboxes marked `[x]` |
+| Original Goal | `.map/<branch>/task_plan_<branch>.md` | Section "## Goal" or first paragraph |
+| Acceptance Criteria | `.map/<branch>/task_plan_<branch>.md` | Section "## Acceptance Criteria" (table) |
+| Completed Subtasks | `.map/<branch>/progress_<branch>.md` | Checkboxes marked `[x]` |
 | Global Validation | Task argument `$VALIDATION_CRITERIA` | Passed from map-efficient.md |
 
 ### OUTPUT Destinations (where to store results)
 
 | Data | Destination | Format | Written By |
 |------|-------------|--------|------------|
-| Verification Result | `.map/progress_<branch>.md` | Append "## Final Verification" section | **final-verifier agent** |
+| Verification Result | `.map/<branch>/progress_<branch>.md` | Append "## Final Verification" section | **final-verifier agent** |
 | Structured Result | `.map/<branch>/final_verification.json` | JSON (for programmatic access) | **final-verifier agent** |
 | Root Cause (if failed) | `.map/<branch>/final_verification.json` | In `root_cause` field | **final-verifier agent** |
 
 **WHO WRITES FILES:**
 - **final-verifier agent** writes verification results to BOTH markdown and JSON
 - **Orchestrator (map-efficient.md)** reads results and decides next action (COMPLETE/RE_DECOMPOSE/ESCALATE)
-- **Orchestrator (map-efficient.md)** ensures Acceptance Criteria section exists in `task_plan_<branch>.md` (derived from decomposition output)
+- **Orchestrator (map-efficient.md)** ensures Acceptance Criteria section exists in `.map/<branch>/task_plan_<branch>.md` (derived from decomposition output)
 
 **IMPORTANT:** Always use sanitized branch name (e.g., `feature-foo` not `feature/foo`).
 
 **SOURCE OF TRUTH CONTRACT:**
 - `.map/<branch>/final_verification.json` is the **ONLY** source of truth for orchestrator decisions
-- `.map/progress_<branch>.md` "## Final Verification" section is for **human readability only**
+- `.map/<branch>/progress_<branch>.md` "## Final Verification" section is for **human readability only**
 - **Orchestrator (map-efficient.md) MUST read JSON**, not parse markdown
 - Both must be written, but only JSON is used programmatically
 
 ## Verification Protocol
 
 ### Step 1: Goal Extraction
-Read `.map/task_plan_<branch>.md` to extract:
+Read `.map/<branch>/task_plan_<branch>.md` to extract:
 - Original goal from "## Goal" section
 - Acceptance criteria from "## Acceptance Criteria" table (if present)
 
@@ -101,7 +101,7 @@ Score confidence (0.0-1.0):
 
 **CRITICAL:** `root_cause` is REQUIRED if `passed=false`
 
-### 2. Append to `.map/progress_<branch>.md`
+### 2. Append to `.map/<branch>/progress_<branch>.md`
 
 ```markdown
 ## Final Verification

{mapify_cli-3.1.0 → mapify_cli-3.2.0}/src/mapify_cli/templates/agents/monitor.md

@@ -94,8 +94,8 @@ If implementation deviates from the AAG contract — `valid: false` — regardle
 |-------------|------|-------------|---------|
 | `{{project_name}}` | string | Project identifier | `"auth-service"` |
 | `{{language}}` | enum | Primary language | `"python"`, `"typescript"`, `"go"` |
-| `{{solution}}` | string | Code/docs to review | Full code block or diff |
-| `{{requirements}}` | string | Subtask requirements | "Implement JWT validation" |
+| `{{solution}}` | string | Code/docs to review (in MAP workflow: provided via `<MAP_Written>` tag) | Full code block or diff |
+| `{{requirements}}` | string | Subtask requirements (in MAP workflow: provided via `<MAP_Contract>` tag) | "Implement JWT validation" |
 | `{{review_mode}}` | enum | Review scope mode | `"full"` or `"diff"` |
 
 ### Optional Placeholders
@@ -105,6 +105,7 @@ If implementation deviates from the AAG contract — `valid: false` — regardle
 | `{{framework}}` | string | `""` | Framework/runtime (Express, FastAPI, etc.) |
 | `{{standards_doc}}` | string | `""` | URL/path to style guide |
 | `{{security_policy}}` | string | `""` | URL/path to security policy |
+| `{{changed_files}}` | array | `[]` | List of modified file paths (for static analysis) |
 | `{{subtask_description}}` | string | `""` | Additional context |
 | `{{existing_patterns}}` | array | `[]` | Learned patterns from previous reviews |
 | `{{feedback}}` | array | `[]` | Previous review findings to verify |
@@ -2494,3 +2495,27 @@ def check_rate_limit(user_id, action, limit=100, window=3600):
 - Only MEDIUM/LOW issues → valid=true (with feedback)
 
 </Monitor_Critical_Reminders>
+
+### Evidence File (Artifact-Gated Validation)
+
+**Exception to read-only rule**: Monitor writes evidence files to `.map/` artifacts directory via Bash (not Write tool). This does NOT violate the read-only-for-project-code rule — `.map/` is a workflow artifact directory, not project code.
+
+After completing validation, write an evidence file:
+
+```bash
+cat > .map/<branch>/evidence/monitor_<subtask_id>.json << 'EVIDENCE'
+{
+  "phase": "MONITOR",
+  "subtask_id": "<subtask_id>",
+  "timestamp": "<ISO 8601 UTC>",
+  "valid": true,
+  "issues_found": <number of issues>,
+  "recommendation": "approve|reject|revise"
+}
+EVIDENCE
+```
+
+**Required fields** (orchestrator validates these): `phase`, `subtask_id`, `timestamp`.
+Other fields are informational but recommended for audit trail.
+
+**CRITICAL**: Without this file, `validate_step("2.4")` will reject the step.