**After saving COMPLETION.md:** ```bash ./coordination/scripts/fix-permissions.sh git add coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/COMPLETION.md git add coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/PROGRESS.md git commit -m "completion: MP-{NNNN} {feature} implementation report" git push origin main ``` **KRITISK:** Uten git commit+push vil COMPLETION.md og PROGRESS.md forsvinne ved neste session. Audit-agenten trenger disse filene. ---

Run `/audit-masterplan` for post-implementation audit. ```

⚠️ User MUST test these URLs: - {url1}: {what to verify} - {url2}: {what to verify}

- [{type}] {title} → {domain}/pending-updates.json

- {file3}: {brief description} - {file4}: {brief description}

- {file1} - {file2}

- Routes: ✅ {N} new routes registered - Migrations: ✅ {N} new run - Syntax: ✅ All files OK - Cache: ✅ Cleared - Queue: ✅ Restarted (if relevant)

| # | Criterion | Status | Verification | |---|-----------|--------|--------------| | 1 | {criterion} | ✅ Verified | {method} | | 2 | {criterion} | ⚠️ Frontend | User must test |

| Review finding | Incorporated in | Status | |----------------|-----------------|--------| | K-001: {title} | TASK-002 | ✅ | | A-001: {title} | TASK-003 | ✅ |

| Task | Status | Commit | Files | |------|--------|--------|-------| | TASK-001 | ✅ DONE | abc1234 | file1.php, file2.php | | TASK-002 | ✅ DONE | def5678 | file3.blade.php | | TASK-003 | ⚠️ PARTIAL | - | Reason: {why} |

**Save completion report:** ``` coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/COMPLETION.md ``` **Format:** ```markdown # Completion Report: MP-{NNNN} **Masterplan:** {filename} **Implemented:** {date} **Execution Mode:** {SOLO SEQUENTIAL/SOLO PARALLEL}

- File budgets: ✅ All within limits / ⚠️ {file}: N lines (over 400L target) - window.* globals: ✅ None / ❌ Found: {list} - Hardcoded /api/ paths: ✅ None / ❌ Found: {list} ``` **If PHPStan errors are found:** Fix them before calling the MP complete. Only add to baseline if they are caused by 3rd-party BC issues with a written justification. **If PHPArkitect violations found:** STOP — these are architecture regressions that MUST be fixed. **If file is over 800 lines:** STOP — split the file....

- ESLint: ✅ 0 errors / ❌ N errors → [must fix] - Knip: ✅ No dead code / ⚠️ N unused exports → [cleaned up]

- PHPStan: ✅ 0 new errors / ⚠️ N new errors → [action taken] - Pint: ✅ Style clean / ⚠️ N style issues → auto-fixed (`composer pint-fix`) - PHPMD: ✅ No violations / ⚠️ N violations → [details] - PHPArkitect: ✅ All rules pass / ❌ N violations → [must fix]

**After all tasks are implemented, go through EACH acceptance criterion:** ``` Acceptance criteria from MP-{NNNN}: - [ ] Criterion 1 → Verified: {how} - [ ] Criterion 2 → Verified: {how} - [ ] Criterion 3 → ⚠️ Can't verify (frontend) → user must test ``` **Live verification (RUN these):** ```bash php artisan route:list --path={relevant} # Routes registered? php artisan migrate:status # Migrations run? php -l {all new/changed PHP files} # Syntax OK? npm run...

**When user provides "Resume: MP-{NNNN}-HANDOFF.md":** ``` 1. Check for PROGRESS.md first (fastest path): coordination/masterplans/active/MP-{NNNN}-*/PROGRESS.md 2. If PROGRESS.md exists: read it (< 40 lines), skip to remaining tasks 3. If no PROGRESS.md: read HANDOFF.md instead 4. Read MASTERPLAN.md (Level 1: Task Index) — ~50-80 lines 5. Read CONTEXT.md (Level 2: Shared Context) — ~80-150 lines 6. For next task: Read tasks/TASK-{NNN}.md — ~40-80 lines 7. Read expert file ONLY if...

- TASK-{NNN}: {title} - TASK-{NNN+1}: {title} - ... ``` **Then show THIS to user (copy-paste ready):** ``` --- HANDOFF READY Paste this in new chat: /implement-masterplan Resume: coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/HANDOFF.md --- ``` **RULES for handoff:** - Key context: MAX 5-8 bullet points (only what next LLM NEEDS) - Completed tasks: Only commit-hash + 1-line summary (no details) - NEVER include entire masterplan content in handoff - NEVER include review...

- {file1}: {brief description} - {file2}: {brief description}

- {Important architecture decision 1} - {Pattern/convention established} - {File created and used by next task} - {Gotcha/pitfall discovered}

**TASK-{NNN}: {title}** Read ONLY this section in masterplan (not entire file).

| Task | Commit | Key changes | |------|--------|-------------| | TASK-001 | {hash7} | {1 line: what was created/changed} | | TASK-002 | {hash7} | {1 line} |

**When user requests "handoff" or context is low, generate HANDOFF file.** **Trigger:** User says "handoff", "handover", "new session", "context full" etc. **IMMEDIATELY write this file:** ``` coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/HANDOFF.md ``` **Format (STRICT - don't add extras!):** ```markdown # Handoff: MP-{NNNN} - Resume TASK-{NNN} **Generated:** {date} **Masterplan:** coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/MASTERPLAN.md **Expert:**...

A) **Revert commit:** `git revert {hash}` — undo scope creep, re-implement correctly B) **Accept pre-emption:** Mark affected future tasks as DONE in PROGRESS.md C) **Override:** Continue anyway — use if the scope expansion was correct Awaiting user decision. ``` 2. **Update PROGRESS.md:** Set Scope column to `L2-BLOCK` for this task 3. **STOP implementation.** Do NOT proceed to the next task. 4. **Report to user:** Show the SCOPE-BLOCK.md content and ask which option to take. ---

{list with L2's MISSING_JUDGEMENT}

{list with L2's EXTRA_JUDGEMENT}

**Runs automatically after step 9 (commit), before step 12 (PROGRESS.md update).** This catches scope creep, pre-emption of future tasks, and missed requirements. #### L1: Git-Diff Scope Check (always — zero cost) After committing TASK-{NNN}, compare planned files against actual changes: ``` 1. EXTRACT planned files from TASK-{NNN}.md: Read the task file's ## Files section. Two formats exist: Format A (newer): ## Files - **Create:** `path/to/file.py` (~N lines, description) ...

{Any context the next agent needs - blockers, decisions made, etc.} ``` **Rules:** - Write PROGRESS.md after EVERY completed task (not just at end) - Overwrite the file each time (latest state only) - Keep it < 50 lines - Scope values: MATCH, WARN, ANOMALY, L2-PASS, L2-BLOCK, SKIP, - (not done) - Include commit hashes so next agent can verify - This file is the SINGLE SOURCE OF TRUTH for task completion **⚠️ IMPORTANT: Implement what the plan says - DO NOT improvise!** ``` ❌ "I added an extra...

**Next task:** TASK-003 **Expert file:** {path to expert file if loaded} **Review fixes remaining:** {K-XXX list or "none"}

| Task | Title | Status | Commit | Scope | |------|-------|--------|--------|-------| | TASK-001 | {title} | DONE | {short hash} | MATCH | | TASK-002 | {title} | DONE | {short hash} | WARN | | TASK-003 | {title} | IN_PROGRESS | - | - | | TASK-004 | {title} | PENDING | - | - | | TASK-005 | {title} | PENDING | - | - |

**Write/update PROGRESS.md after EVERY completed task.** This enables orchestrators and new sessions to resume without re-reading the entire masterplan. **File:** `coordination/masterplans/active/MP-{NNNN}-{YYMMDD}-{feature}/PROGRESS.md` ```markdown # Progress: MP-{NNNN} **Updated:** {ISO timestamp} **Agent:** implement-masterplan

**For EACH task in masterplan:** ``` 1. MARK as in_progress in TodoWrite 2. Read this task's file: {MP directory}/tasks/TASK-NNN.md (~40-80 lines) → Each task is its own file — no offset/limit needed, read the whole file → DO NOT read other task files or re-read MASTERPLAN.md/CONTEXT.md! → Legacy (no tasks/ dir): Use offset/limit to read TASK-NNN section from MASTERPLAN.md 3. Check dependencies (are previous tasks complete?) 4. CHECK if any files already have uncommitted changes...

**Auto-generate TodoWrite from masterplan's tasks + acceptance criteria:** ``` TodoWrite: - TASK-001: {title} (pending) - TASK-002: {title} (pending) - ... - Verify acceptance criteria (pending) - Generate completion report (pending) ``` Include review-fixes as part of relevant tasks (NOT as separate tasks). ---

**Parse masterplan's execution mode:** #### SOLO SEQUENTIAL (standard) ✅ → Implement all tasks in sequence in this chat → Most common, recommended for <5 tasks #### SOLO PARALLEL → Ask user: "Which tasks should THIS chat handle?" → Show file separation from masterplan → Other tasks run in parallel `/implement-masterplan` windows ``` This masterplan uses SOLO PARALLEL. File separation: - TASK-001 + TASK-002: {files} → Window 1 - TASK-003 + TASK-004: {files} → Window 2 Which tasks should I...

**Identify affected domains from masterplan:** ```bash ./coordination/scripts/discover-experts.sh --list ``` **Read relevant CURRENT.md expert file(s):** ``` coordination/experts/{category}/{domain}/CURRENT.md ``` Focus on: - Gotchas (common mistakes in this domain) - Patterns (existing conventions) - Integration points ---

```bash # Find review for this masterplan (use MP-number) ls coordination/masterplans/active/MP-{NNNN}-*/REVIEW*.md 2>/dev/null ``` **IF review exists:** ``` 📝 Review found: MP-{NNNN}-REVIEW.md Reading critical findings (K-XXX)... - K-001: {title} → Incorporated into TASK-{N} - K-002: {title} → Incorporated into TASK-{N} {N} critical findings incorporated into implementation plan. ``` → Incorporate ALL critical findings (K-XXX) into implementation → Incorporate warnings (A-XXX) where...

**WAIT for user to provide masterplan file. DO NOT search or list masterplans yourself!** User will provide filename or MP-number. When you have it, locate the MP directory: ```bash ls coordination/masterplans/active/MP-{NNNN}-*/ ``` **Step 0a: Read MASTERPLAN.md (Level 1 — ~50-80 lines)** ``` Read {MP directory}/MASTERPLAN.md This file IS Level 1 — no truncation needed, read the whole file. Extract: - Summary / Executive Summary - Task Index table (task count, titles, agents, files,...

``` ✅ Completion reports → coordination/masterplans/active/ ❌ NEVER write files directly to coordination/ root ``` ---

``` ❌ sudo/chown/chmod = DOES NOT WORK (ask user) ✅ sudo systemctl restart puppeteer-server (works!) ```

``` Changed CSS/JS/TS/Tailwind → npm run build Changed PHP code → php artisan optimize:clear Changed Jobs/Services/Config → php artisan queue:restart Full sequence after mixed changes: npm run build && php artisan optimize:clear && php artisan queue:restart ``` **Without `npm run build` → CSS/JS changes are INVISIBLE (old bundle served!)**

```bash # BEFORE stash: git status --porcelain - are ALL changes MINE? # ❌ NEVER stash without checking # ✅ git stash push -m "implement-mp: {MP-number} - {date}" ```

```bash git add file1 file2 # ✅ Only YOUR files git add . # ❌ NEVER! Stages others' work! ```

``` ⚠️ FACTS: - This IS the production server (no staging/dev) - All changes affect LIVE data immediately - Multiple LLM sessions may work SIMULTANEOUSLY ❌ NEVER: migrate:fresh, migrate:reset, db:wipe, git reset --hard ✅ ALLOWED: migrate (forward-only), migrate:rollback --step=1 (with approval) ``` ---

Read `Quality Mode:` from MASTERPLAN.md. This controls which steps you run. | Step | SPEED | BALANCED | THOROUGH | |------|-------|----------|----------| | Step 0: Read Masterplan | ✅ L1+L2 | ✅ L1+L2 | ✅ L1+L2 | | Step 1: Check Review | ❌ Skip | ✅ If exists | ✅ Required | | Step 2: Load Experts | ❌ Skip | ✅ 1-3 key files | ✅ All relevant | | Step 3: Execution Mode | ✅ | ✅ | ✅ | | Step 4: TodoWrite | ✅ | ✅ | ✅ | | Step 5: Implement | ✅ Full | ✅ Full | ✅ Full | | Step 5a: PROGRESS.md | ✅ Final...

All 10 MCP servers are active (deferred loading — 0 cost until first use). For implementation: **Quick Fetch — load tools by implementation phase:** ``` # Code navigation (ALWAYS — before reading files) ToolSearch("select:mcp__serena__find_symbol,mcp__serena__get_symbols_overview,mcp__serena__find_referencing_symbols,mcp__serena__replace_symbol_body") # Data verification ToolSearch("select:mcp__mysql__execute_sql") # UI verification (after frontend...

**CRITICAL:** Before spawning sub-agents with Task tool, analyze task complexity: | Type | Agent | Cost | Criteria | |------|-------|------|----------| | Simple | generic-light | 1x | <50 LOC, 1-2 files | | Moderate | generic-fast-thinking | 4x | 50-200 LOC, 2-5 files, requires analysis | | Complex | generic-balanced-thinking | 33x | 200+ LOC, 5-10 files, cross-domain | | Synthesis | generic-quality | 38x | Expert files, scoring, docs | **Full guide:**...

**Input:** Masterplan file (MP-{NNNN}-MASTERPLAN.md) from architect **Output:** Implemented code + COMPLETION.md report **Pipeline position:** /explore → /architect → /review-masterplan → /patch-revise-masterplan → **/implement-masterplan** → /audit-masterplan → /quality-audit-masterplan ---

This server runs Apache 2.4 + PHP-FPM 8.3 (NOT nginx!). - External reverse proxy (Nginx Proxy Manager) at 172.20.0.42 handles SSL/HTTPS - NEVER reference nginx config (doesn't exist on this server) - NEVER suggest SSL/cert changes (handled by external proxy) - Apache commands: a2enmod, a2ensite, apachectl ---

``` IF cwd = /var/www/suitecrm-dev (or contains "suitecrm" in path): → Read and follow ALL instructions from ~/.claude/agents/implement-masterplan-suitecrm.md → Do NOT use this file for implementation. ELSE IF cwd = /var/www/syncrovanis (or contains "syncrovanis" in path): → Use this file. Tech stack: Python/Flask dashboard + Bash engine. No Laravel/artisan. ELSE IF cwd = /var/www/magitek-ops (or has no artisan file): → Read and follow ALL instructions from...

| Operation | MCP Tool | |-----------|----------| | Deploy view definition | `deploy_metadata_file` | | Deploy extension file | `deploy_extension_file` | | Deploy Angular source | `deploy_extension_source_file` | | Build Angular extension | `build_extension` | | Set translations | `set_label` | | Deploy CSS | `deploy_css` (extension) or scp (global) | | Clear cache | `cache_clear` | | Rebuild extensions | `rebuild_extensions` | --- **You are the Masterplan Implementer for SuiteCRM Dev.**...

``` Save to: `coordination/masterplans/active/MP-{NNNN}-{slug}/COMPLETION.md` ---