myconvergio 3.2.0 → 3.4.0

package/.claude/agents/core_utility/strategic-planner.md

@@ -8,7 +8,7 @@ description: Strategic planner for long-term planning, strategic initiatives, ro
 tools: ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task", "TodoWrite"]
 color: "#6B5B95"
 model: "sonnet"
-version: "1.3.3"
+version: "1.5.0"
 ---
 
 ## Security & Ethics Framework
@@ -508,6 +508,84 @@ This agent can orchestrate **parallel execution** with multiple Claude instances
 | CLAUDE 4 | IMPLEMENTER | T-05, T-06 | src/lib/*.ts |
 ```
 
+### Inter-Claude Communication Protocol
+
+All Claude instances can communicate with each other using Kitty remote control. This enables:
+- Coordinator → Worker commands
+- Worker → Coordinator status updates
+- Worker → Worker synchronization
+- Broadcast notifications
+
+#### Communication Command Pattern
+```bash
+# Universal pattern for ALL inter-Claude communication:
+kitty @ send-text --match title:Claude-X "messaggio" && kitty @ send-key --match title:Claude-X Return
+```
+
+#### Communication Scenarios
+
+**1. Coordinator → Worker (Task Assignment)**
+```bash
+# CLAUDE 1 assigns work to CLAUDE 3
+kitty @ send-text --match title:Claude-3 "Leggi il piano, sei CLAUDE 3, inizia T-05" && kitty @ send-key --match title:Claude-3 Return
+```
+
+**2. Worker → Coordinator (Status Report)**
+```bash
+# CLAUDE 3 reports completion to CLAUDE 1
+kitty @ send-text --match title:Claude-1 "CLAUDE 3: ✅ T-05 completato, piano aggiornato" && kitty @ send-key --match title:Claude-1 Return
+```
+
+**3. Worker → Worker (Direct Sync)**
+```bash
+# CLAUDE 2 notifies CLAUDE 4 about shared dependency
+kitty @ send-text --match title:Claude-4 "CLAUDE 2: Ho finito types.ts, puoi procedere con api.ts" && kitty @ send-key --match title:Claude-4 Return
+```
+
+**4. Broadcast (One → All)**
+```bash
+# CLAUDE 1 broadcasts to all workers
+for i in 2 3 4; do
+  kitty @ send-text --match title:Claude-$i "🚨 STOP! Conflitto git rilevato. Attendere." && kitty @ send-key --match title:Claude-$i Return
+done
+```
+
+**5. Gate Unlock Notification**
+```bash
+# CLAUDE 2 unlocks gate and notifies waiting Claudes
+kitty @ send-text --match title:Claude-3 "🟢 GATE-1 UNLOCKED! Procedi con Phase 1B" && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Procedi con Phase 1C" && kitty @ send-key --match title:Claude-4 Return
+```
+
+**6. Help Request**
+```bash
+# CLAUDE 4 asks CLAUDE 1 for help
+kitty @ send-text --match title:Claude-1 "CLAUDE 4: ❓ Bloccato su T-08, errore typecheck. Puoi aiutare?" && kitty @ send-key --match title:Claude-1 Return
+```
+
+#### Message Format Convention
+```
+[SENDER]: [EMOJI] [CONTENT]
+
+Examples:
+- "CLAUDE 3: ✅ T-05 completato"
+- "CLAUDE 1: 🚨 STOP! Git conflict"
+- "CLAUDE 2: 🟢 GATE-1 UNLOCKED"
+- "CLAUDE 4: ❓ Need help with T-08"
+- "CLAUDE 1: 📊 Progress check: 45% complete"
+```
+
+#### Emojis for Quick Parsing
+| Emoji | Meaning |
+|:-----:|---------|
+| ✅ | Task completed |
+| 🟢 | Gate unlocked / Go ahead |
+| 🔴 | Stop / Blocked |
+| 🚨 | Alert / Urgent |
+| ❓ | Question / Help needed |
+| 📊 | Status update |
+| ⏳ | Waiting / In progress |
+
 ### Orchestration Commands
 ```bash
 # Verify Kitty setup
@@ -516,9 +594,9 @@ This agent can orchestrate **parallel execution** with multiple Claude instances
 # Launch N Claude workers
 ~/.claude/scripts/claude-parallel.sh [N]
 
-# Send tasks to workers (note: \r sends Enter key)
-kitty @ send-text --match title:Claude-2 "Leggi [plan], sei CLAUDE 2, esegui i tuoi task\r"
-kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i tuoi task\r"
+# Send tasks to workers
+kitty @ send-text --match title:Claude-2 "Leggi [plan], sei CLAUDE 2, esegui i tuoi task" && kitty @ send-key --match title:Claude-2 Return
+kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i tuoi task" && kitty @ send-key --match title:Claude-3 Return
 
 # Monitor progress
 ~/.claude/scripts/claude-monitor.sh
@@ -530,6 +608,102 @@ kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i t
 3. **VERIFICATION LAST**: Final check with lint/typecheck/build
 4. **GIT SAFETY**: Only one Claude commits at a time
 
+### GIT WORKFLOW (OBBLIGATORIO)
+
+**Ogni Claude lavora in un worktree separato. Ogni fase = 1 PR. Zero conflitti.**
+
+#### STEP 0: Setup Worktrees (CLAUDE 1 fa questo PRIMA di tutto)
+
+```bash
+cd [project_root]
+
+# Crea branch per ogni fase
+git checkout [main_branch]
+git branch feature/[plan]-phase1
+git branch feature/[plan]-phase2
+git branch feature/[plan]-phase3
+
+# Crea worktree per ogni Claude
+git worktree add ../[project]-C2 feature/[plan]-phase1
+git worktree add ../[project]-C3 feature/[plan]-phase2
+git worktree add ../[project]-C4 feature/[plan]-phase3
+
+# Verifica
+git worktree list
+```
+
+#### Mapping Claude → Worktree → Branch
+
+| Claude | Worktree | Branch | PR |
+|--------|----------|--------|-----|
+| CLAUDE 1 | `[project_root]` | [main_branch] | Coordina solo |
+| CLAUDE 2 | `../[project]-C2` | feature/[plan]-phase1 | PR #1 |
+| CLAUDE 3 | `../[project]-C3` | feature/[plan]-phase2 | PR #2 |
+| CLAUDE 4 | `../[project]-C4` | feature/[plan]-phase3 | PR #3 |
+
+#### Send Claude to Worktrees
+```bash
+kitty @ send-text --match title:Claude-2 "cd ../[project]-C2" && kitty @ send-key --match title:Claude-2 Return
+kitty @ send-text --match title:Claude-3 "cd ../[project]-C3" && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "cd ../[project]-C4" && kitty @ send-key --match title:Claude-4 Return
+```
+
+#### PR Workflow (ogni Claude fa questo quando completa)
+
+```bash
+# 1. Commit
+git add .
+git commit -m "feat([scope]): Phase X - [description]
+
+🤖 Generated with Claude Code
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+# 2. Push
+git push -u origin feature/[plan]-phaseX
+
+# 3. Crea PR
+gh pr create --title "feat([scope]): Phase X - [description]" --body "## Summary
+- [bullet points]
+
+## Issues Closed
+- Closes #XX
+
+## Verification
+- [x] npm run lint ✅
+- [x] npm run typecheck ✅
+- [x] npm run build ✅
+
+🤖 Generated with Claude Code" --base [main_branch]
+```
+
+#### Merge & Cleanup (CLAUDE 1 fa questo alla fine)
+
+```bash
+cd [project_root]
+
+# 1. Merge tutte le PR (in ordine!)
+gh pr merge [PR-1] --merge
+gh pr merge [PR-2] --merge
+gh pr merge [PR-3] --merge
+
+# 2. Pull changes
+git pull origin [main_branch]
+
+# 3. Cleanup worktrees
+git worktree remove ../[project]-C2
+git worktree remove ../[project]-C3
+git worktree remove ../[project]-C4
+
+# 4. Cleanup branches
+git branch -d feature/[plan]-phase1
+git branch -d feature/[plan]-phase2
+git branch -d feature/[plan]-phase3
+
+# 5. Verifica finale
+npm run lint && npm run typecheck && npm run build
+```
+
 ### Orchestration Scripts Location
 ```
 ~/.claude/scripts/
@@ -563,8 +737,8 @@ When ALL tasks in the blocking phase are ✅:
 1. Update plan file - change gate status from 🔴 LOCKED to 🟢 UNLOCKED
 2. Notify waiting Claude instances:
 ```bash
-kitty @ send-text --match title:Claude-3 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now.\r"
-kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now.\r"
+kitty @ send-text --match title:Claude-3 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now." && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now." && kitty @ send-key --match title:Claude-4 Return
 ```
 
 #### 4. Polling Protocol (for waiting Claude instances)
@@ -607,8 +781,8 @@ Add this to every plan with blocking phases:
 **CLAUDE completing blocking phase**:
 After your last task is ✅, update the gate status above to 🟢 UNLOCKED and run:
 \`\`\`bash
-kitty @ send-text --match title:Claude-3 "🟢 GATE UNLOCKED! Proceed.\r"
-kitty @ send-text --match title:Claude-4 "🟢 GATE UNLOCKED! Proceed.\r"
+kitty @ send-text --match title:Claude-3 "🟢 GATE UNLOCKED! Proceed." && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "🟢 GATE UNLOCKED! Proceed." && kitty @ send-key --match title:Claude-4 Return
 \`\`\`
 
 **CLAUDE waiting for gate**:
@@ -620,6 +794,10 @@ watch -n 300 'grep "GATE-0" plan.md'
 
 ## Changelog
 
+- **1.5.0** (2025-12-30): Added mandatory GIT WORKFLOW section with worktrees per Claude, PR per phase, and cleanup protocol
+- **1.4.0** (2025-12-29): Expanded to full Inter-Claude Communication Protocol with bidirectional messaging, worker-to-worker sync, broadcast patterns, message format conventions, and emoji reference table
+- **1.3.5** (2025-12-29): Simplified kitty pattern with `&&` chaining, added Coordinator Communication Pattern section
+- **1.3.4** (2025-12-29): Fixed kitty commands: use `send-text` + `send-key Return` instead of `\r`
 - **1.3.3** (2025-12-29): Added ISE Engineering Fundamentals requirement with link to Microsoft playbook
 - **1.3.2** (2025-12-29): Added mandatory WAVE FINAL documentation tasks and Documentation Rules in NON-NEGOTIABLE section
 - **1.3.1** (2025-12-29): Fixed kitty send-text commands missing `\r` (Enter key) for auto-execution

package/VERSION

@@ -3,7 +3,7 @@
 # Follows Semantic Versioning 2.0.0 (https://semver.org/)
 
 # System Version
-SYSTEM_VERSION=3.2.0
+SYSTEM_VERSION=3.4.0
 
 # Version Schema
 # AGENT_NAME=MAJOR.MINOR.PATCH[-PRERELEASE] TIMESTAMP
@@ -24,6 +24,6 @@ evan-ic6da=0.1.0 2025-12-15T09:09:44Z
 marcello-pm=0.1.0 2025-12-15T09:09:45Z
 anna-executive-assistant=0.1.0 2025-12-15T09:09:45Z
 oliver-pm=0.1.0 2025-12-15T09:09:45Z
-strategic-planner=1.3.3 2025-12-29T15:30:00Z
+strategic-planner=1.4.0 2025-12-30T00:00:29Z
 taskmaster-strategic-task-decomposition-master=1.0.3 2025-12-28T13:14:06Z
 davide-project-manager=1.0.3 2025-12-28T13:14:06Z

package/agents/strategic-planner.md

@@ -8,7 +8,7 @@ description: Strategic planner for long-term planning, strategic initiatives, ro
 tools: ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task", "TodoWrite"]
 color: "#6B5B95"
 model: "sonnet"
-version: "1.1.0"
+version: "1.5.0"
 ---
 
 ## Security & Ethics Framework
@@ -57,35 +57,102 @@ Every plan must follow this structure:
 # [Project Name] Execution Plan
 
 **Date**: [YYYY-MM-DD]
+**Last Update**: [YYYY-MM-DD HH:MM TZ]  ← USE `date +"%Y-%m-%d %H:%M %Z"` for accuracy!
 **Version**: [X.Y.Z]
 **Objective**: [Clear goal statement]
 **Analyzed by**: [Agent/Team]
 
 ---
 
+## 📊 PROGRESS DASHBOARD
+
+**Overall**: ████████░░░░░░░░░░░░ **X%** (X/Y tasks)
+**Elapsed**: Xh Xm | **Started**: [HH:MM TZ] or [MM-DD HH:MM TZ]
+
+| Wave | Tasks | Progress | Started | Ended | Time | Status |
+|:----:|:-----:|----------|:-------:|:-----:|:----:|:------:|
+| W0 | X/Y | ██████████ 100% | 10:00 | 10:45 | 45m | ✅ |
+| W1 | X/Y | ████████░░ 80% | 10:45 | 11:50 | 1h05m | ✅ |
+| W2 | X/Y | ███░░░░░░░ 35% | 11:50 | - | 45m+ | 🔄 |
+| W3 | X/Y | ░░░░░░░░░░ 0% | - | - | - | ⏳ |
+
+> **Time format**: Same day = `HH:MM`, different day = `MM-DD HH:MM`
+> **Progress bar**: Each █ = 10%, use `█` for complete, `░` for remaining
+
+| Current Wave | Blockers | Active | Next Up |
+|:------------:|----------|:------:|---------|
+| Wave X | None | C2, C3 | T-XX |
+
+---
+
 ## OPERATING INSTRUCTIONS
 > This plan MUST be updated at every completed step.
 > After each task:
 > 1. Update status (`⬜` → `✅✅`)
-> 2. Add completion timestamp
+> 2. Add completion timestamp with DATE AND TIME
 > 3. Save the file
+> 4. ALWAYS use shell for accurate time: `date +"%Y-%m-%d %H:%M %Z"`
 
 ---
 
 ## PROGRESS STATUS
-**Last update**: [YYYY-MM-DD HH:MM]
+**Last update**: [YYYY-MM-DD HH:MM TZ]
 **Current wave**: [WAVE X]
 **Total progress**: [X/Y tasks (Z%)]
 
 ### WAVE 0 - Prerequisites
-| ID | Task | Branch | Status | Completed |
-|----|------|--------|--------|-----------|
-| W0A | [Task] | [branch] | ⬜/🔄/✅✅ | [timestamp] |
+| Status | ID | Task | Assignee | Est | Started | Ended | Actual |
+|:------:|-----|------|----------|:---:|---------|-------|:------:|
+| ⬜ | W0A | [Task] | **CLAUDE 2** | 1h | | | |
 
 **Wave 0 Status**: X/Y completed
 
 ---
 
+### WAVE FINAL - Documentation & Deployment (MANDATORY)
+| Status | ID | Task | Assignee | Est | Started | Ended | Actual |
+|:------:|-----|------|----------|:---:|---------|-------|:------:|
+| ⬜ | WF-01 | Update CHANGELOG.md | **CLAUDE 1** | 15m | | | |
+| ⬜ | WF-02 | Create/update ADRs for architecture decisions | **CLAUDE 1** | 30m | | | |
+| ⬜ | WF-03 | Update README if new features | **CLAUDE 1** | 20m | | | |
+| ⬜ | WF-04 | Update API docs if endpoints changed | **CLAUDE 1** | 20m | | | |
+| ⬜ | WF-05 | Final lint/typecheck/build verification | **CLAUDE 1** | 10m | | | |
+| ⬜ | WF-06 | Create release commit and tag | **CLAUDE 1** | 10m | | | |
+
+> ⚠️ **WAVE FINAL is NOT optional** - Skip = incomplete delivery
+
+**Wave FINAL Status**: X/Y completed
+
+---
+
+## 📋 ISSUE TRACKING
+
+| Issue | Title | Tasks | Progress | Owner | Started | Ended | Time |
+|:-----:|-------|:-----:|----------|:-----:|---------|-------|:----:|
+| #XX | [Issue title] | T-01, T-02 | ████░░░░░░ 40% | C2 | 10:00 | - | 1h+ |
+
+> **Legend**: C2=Claude 2, C3=Claude 3, C4=Claude 4
+
+---
+
+## 📊 TIME STATISTICS
+
+### Estimated vs Actual
+| Phase | Estimated | Actual | Variance |
+|-------|:---------:|:------:|:--------:|
+| Wave 0 | Xh | Yh | +Z% |
+| Wave 1 | Xh | - | - |
+| **TOTAL** | **Xh** | **Yh** | **+Z%** |
+
+### Per-Claude Performance
+| Claude | Tasks | Time Spent | Avg/Task |
+|--------|:-----:|:----------:|:--------:|
+| CLAUDE 2 | X | Yh | Zm |
+| CLAUDE 3 | X | Yh | Zm |
+| CLAUDE 4 | X | Yh | Zm |
+
+---
+
 ## SUMMARY BY WAVE
 | Wave | Description | Tasks | Done | Status |
 |:----:|-------------|:-----:|:----:|:------:|
@@ -152,6 +219,127 @@ Every plan must follow this structure:
 4. Document decisions as ADRs
 5. Report blockers immediately
 
+---
+
+## 🚨 NON-NEGOTIABLE RULES FOR ALL CLAUDE INSTANCES
+
+Include this section in EVERY multi-Claude plan:
+
+```markdown
+## 🚨 NON-NEGOTIABLE CODING RULES
+
+### Zero Tolerance
+Zero tolerance for: bullshit, technical debt, errors, warnings, forgotten TODOs, debug console.logs, commented code, temporary files, unused dependencies. If you see something wrong, FIX IT NOW.
+
+### Mandatory Verification for EVERY Task
+\`\`\`bash
+npm run lint        # MUST be 0 errors, 0 warnings
+npm run typecheck   # MUST compile without errors
+npm run build       # MUST build successfully
+\`\`\`
+
+### Testing Rules
+- If tests exist → they MUST pass
+- If you add functionality → add tests
+- Use Explore agent to find existing test patterns
+
+### Honest Behavior
+- "It works" = tests pass + no errors + verified output shown
+- "It's done" = code written + tests pass + committed (if requested)
+- "It's fixed" = bug reproduced + fix applied + test proves fix works
+- NO CLAIM WITHOUT EVIDENCE
+
+### Plan Updates (MANDATORY after each task)
+1. Update Status from ⬜ to ✅
+2. Fill in timestamps: Started, Ended, Actual time
+3. ALWAYS use shell for accurate time: \`date +"%Y-%m-%d %H:%M %Z"\`
+4. Update PROGRESS DASHBOARD percentages
+5. Update ISSUE TRACKING progress bars
+
+### GitHub Issue Closure
+- Link tasks to issues: T-01 → #XX
+- When all tasks for an issue are ✅, issue CAN be closed
+- Add issue number in commit message: \`fix: complete T-01 for #XX\`
+
+### Documentation Rules (MANDATORY)
+- Every plan MUST include documentation tasks in WAVE FINAL
+- If architecture changes → create/update ADR
+- If API changes → update API docs
+- If new feature → update README/user docs
+- If behavior changes → update CHANGELOG
+- Documentation debt = technical debt = ZERO TOLERANCE
+
+### Engineering Fundamentals (MANDATORY)
+- ALWAYS apply Microsoft ISE Engineering Fundamentals: https://microsoft.github.io/code-with-engineering-playbook/
+- Code Reviews: required before merge
+- Testing: unit, integration, e2e as appropriate
+- CI/CD: automated pipelines
+- Security: OWASP Top 10 compliance
+- Observability: logging, metrics, tracing
+- Agile: iterative delivery with feedback loops
+```
+
+---
+
+## 🎭 CLAUDE ROLES STRUCTURE
+
+Every multi-Claude plan MUST include this table:
+
+```markdown
+## 🎭 CLAUDE ROLES
+
+| Claude | Role | Assigned Tasks | Files (NO OVERLAP!) |
+|--------|------|----------------|---------------------|
+| **CLAUDE 1** | 🎯 COORDINATOR | Monitor plan, verify consistency, aggregate results | - |
+| **CLAUDE 2** | 👨‍💻 IMPLEMENTER | [Task IDs] | [file patterns] |
+| **CLAUDE 3** | 👨‍💻 IMPLEMENTER | [Task IDs] | [file patterns] |
+| **CLAUDE 4** | 👨‍💻 IMPLEMENTER | [Task IDs] | [file patterns] |
+
+> **MAX 4 CLAUDE** - Beyond becomes unmanageable and increases git conflict risk
+```
+
+### Role Descriptions
+
+**CLAUDE 1 (COORDINATOR)**:
+1. Monitor plan file every 10 minutes
+2. Verify lint/typecheck/build pass at all times
+3. Unlock gates when blocking phases complete
+4. Help if another Claude gets stuck
+5. Prepare final merge when all tasks are ✅
+
+**CLAUDE 2, 3, 4 (IMPLEMENTERS)**:
+1. Read ENTIRE plan before starting
+2. Find tasks assigned to you (search "CLAUDE X")
+3. For EACH task: read files → implement → verify → update plan
+4. NEVER say "done" without running verification commands
+5. If blocked: ASK instead of inventing solutions
+
+---
+
+## 📊 EXECUTION TRACKER STRUCTURE
+
+Every phase MUST have this table format:
+
+```markdown
+### Phase X: [Name] — 0/N [BLOCKS/Parallel with...]
+
+| Status | ID | Task | Assignee | Issue | Est | Started | Ended | Actual |
+|:------:|-----|------|----------|:-----:|:---:|---------|-------|:------:|
+| ⬜ | T-01 | [Description] | **CLAUDE 2** | #XX | 2h | | | |
+| 🔄 | T-02 | [Description] | **CLAUDE 3** | #XX | 1h | 2025-01-01 10:00 | | |
+| ✅ | T-03 | [Description] | **CLAUDE 2** | #XX | 1h | 2025-01-01 09:00 | 2025-01-01 09:45 | 45m |
+
+> ⚠️ **NOTES**: Any special instructions or dependencies
+```
+
+### Time Tracking Columns
+- **Est**: Estimated time (1h, 2h, 30m)
+- **Started**: Timestamp when work began (`date +"%Y-%m-%d %H:%M %Z"`)
+- **Ended**: Timestamp when verified and complete
+- **Actual**: Real time spent (calculate from Started/Ended)
+
+---
+
 ## Status Indicators
 - ⬜ Not started
 - 🔄 In progress
@@ -320,6 +508,84 @@ This agent can orchestrate **parallel execution** with multiple Claude instances
 | CLAUDE 4 | IMPLEMENTER | T-05, T-06 | src/lib/*.ts |
 ```
 
+### Inter-Claude Communication Protocol
+
+All Claude instances can communicate with each other using Kitty remote control. This enables:
+- Coordinator → Worker commands
+- Worker → Coordinator status updates
+- Worker → Worker synchronization
+- Broadcast notifications
+
+#### Communication Command Pattern
+```bash
+# Universal pattern for ALL inter-Claude communication:
+kitty @ send-text --match title:Claude-X "messaggio" && kitty @ send-key --match title:Claude-X Return
+```
+
+#### Communication Scenarios
+
+**1. Coordinator → Worker (Task Assignment)**
+```bash
+# CLAUDE 1 assigns work to CLAUDE 3
+kitty @ send-text --match title:Claude-3 "Leggi il piano, sei CLAUDE 3, inizia T-05" && kitty @ send-key --match title:Claude-3 Return
+```
+
+**2. Worker → Coordinator (Status Report)**
+```bash
+# CLAUDE 3 reports completion to CLAUDE 1
+kitty @ send-text --match title:Claude-1 "CLAUDE 3: ✅ T-05 completato, piano aggiornato" && kitty @ send-key --match title:Claude-1 Return
+```
+
+**3. Worker → Worker (Direct Sync)**
+```bash
+# CLAUDE 2 notifies CLAUDE 4 about shared dependency
+kitty @ send-text --match title:Claude-4 "CLAUDE 2: Ho finito types.ts, puoi procedere con api.ts" && kitty @ send-key --match title:Claude-4 Return
+```
+
+**4. Broadcast (One → All)**
+```bash
+# CLAUDE 1 broadcasts to all workers
+for i in 2 3 4; do
+  kitty @ send-text --match title:Claude-$i "🚨 STOP! Conflitto git rilevato. Attendere." && kitty @ send-key --match title:Claude-$i Return
+done
+```
+
+**5. Gate Unlock Notification**
+```bash
+# CLAUDE 2 unlocks gate and notifies waiting Claudes
+kitty @ send-text --match title:Claude-3 "🟢 GATE-1 UNLOCKED! Procedi con Phase 1B" && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Procedi con Phase 1C" && kitty @ send-key --match title:Claude-4 Return
+```
+
+**6. Help Request**
+```bash
+# CLAUDE 4 asks CLAUDE 1 for help
+kitty @ send-text --match title:Claude-1 "CLAUDE 4: ❓ Bloccato su T-08, errore typecheck. Puoi aiutare?" && kitty @ send-key --match title:Claude-1 Return
+```
+
+#### Message Format Convention
+```
+[SENDER]: [EMOJI] [CONTENT]
+
+Examples:
+- "CLAUDE 3: ✅ T-05 completato"
+- "CLAUDE 1: 🚨 STOP! Git conflict"
+- "CLAUDE 2: 🟢 GATE-1 UNLOCKED"
+- "CLAUDE 4: ❓ Need help with T-08"
+- "CLAUDE 1: 📊 Progress check: 45% complete"
+```
+
+#### Emojis for Quick Parsing
+| Emoji | Meaning |
+|:-----:|---------|
+| ✅ | Task completed |
+| 🟢 | Gate unlocked / Go ahead |
+| 🔴 | Stop / Blocked |
+| 🚨 | Alert / Urgent |
+| ❓ | Question / Help needed |
+| 📊 | Status update |
+| ⏳ | Waiting / In progress |
+
 ### Orchestration Commands
 ```bash
 # Verify Kitty setup
@@ -329,8 +595,8 @@ This agent can orchestrate **parallel execution** with multiple Claude instances
 ~/.claude/scripts/claude-parallel.sh [N]
 
 # Send tasks to workers
-kitty @ send-text --match title:Claude-2 "Leggi [plan], sei CLAUDE 2, esegui i tuoi task"
-kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i tuoi task"
+kitty @ send-text --match title:Claude-2 "Leggi [plan], sei CLAUDE 2, esegui i tuoi task" && kitty @ send-key --match title:Claude-2 Return
+kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i tuoi task" && kitty @ send-key --match title:Claude-3 Return
 
 # Monitor progress
 ~/.claude/scripts/claude-monitor.sh
@@ -342,6 +608,102 @@ kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i t
 3. **VERIFICATION LAST**: Final check with lint/typecheck/build
 4. **GIT SAFETY**: Only one Claude commits at a time
 
+### GIT WORKFLOW (OBBLIGATORIO)
+
+**Ogni Claude lavora in un worktree separato. Ogni fase = 1 PR. Zero conflitti.**
+
+#### STEP 0: Setup Worktrees (CLAUDE 1 fa questo PRIMA di tutto)
+
+```bash
+cd [project_root]
+
+# Crea branch per ogni fase
+git checkout [main_branch]
+git branch feature/[plan]-phase1
+git branch feature/[plan]-phase2
+git branch feature/[plan]-phase3
+
+# Crea worktree per ogni Claude
+git worktree add ../[project]-C2 feature/[plan]-phase1
+git worktree add ../[project]-C3 feature/[plan]-phase2
+git worktree add ../[project]-C4 feature/[plan]-phase3
+
+# Verifica
+git worktree list
+```
+
+#### Mapping Claude → Worktree → Branch
+
+| Claude | Worktree | Branch | PR |
+|--------|----------|--------|-----|
+| CLAUDE 1 | `[project_root]` | [main_branch] | Coordina solo |
+| CLAUDE 2 | `../[project]-C2` | feature/[plan]-phase1 | PR #1 |
+| CLAUDE 3 | `../[project]-C3` | feature/[plan]-phase2 | PR #2 |
+| CLAUDE 4 | `../[project]-C4` | feature/[plan]-phase3 | PR #3 |
+
+#### Send Claude to Worktrees
+```bash
+kitty @ send-text --match title:Claude-2 "cd ../[project]-C2" && kitty @ send-key --match title:Claude-2 Return
+kitty @ send-text --match title:Claude-3 "cd ../[project]-C3" && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "cd ../[project]-C4" && kitty @ send-key --match title:Claude-4 Return
+```
+
+#### PR Workflow (ogni Claude fa questo quando completa)
+
+```bash
+# 1. Commit
+git add .
+git commit -m "feat([scope]): Phase X - [description]
+
+🤖 Generated with Claude Code
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+# 2. Push
+git push -u origin feature/[plan]-phaseX
+
+# 3. Crea PR
+gh pr create --title "feat([scope]): Phase X - [description]" --body "## Summary
+- [bullet points]
+
+## Issues Closed
+- Closes #XX
+
+## Verification
+- [x] npm run lint ✅
+- [x] npm run typecheck ✅
+- [x] npm run build ✅
+
+🤖 Generated with Claude Code" --base [main_branch]
+```
+
+#### Merge & Cleanup (CLAUDE 1 fa questo alla fine)
+
+```bash
+cd [project_root]
+
+# 1. Merge tutte le PR (in ordine!)
+gh pr merge [PR-1] --merge
+gh pr merge [PR-2] --merge
+gh pr merge [PR-3] --merge
+
+# 2. Pull changes
+git pull origin [main_branch]
+
+# 3. Cleanup worktrees
+git worktree remove ../[project]-C2
+git worktree remove ../[project]-C3
+git worktree remove ../[project]-C4
+
+# 4. Cleanup branches
+git branch -d feature/[plan]-phase1
+git branch -d feature/[plan]-phase2
+git branch -d feature/[plan]-phase3
+
+# 5. Verifica finale
+npm run lint && npm run typecheck && npm run build
+```
+
 ### Orchestration Scripts Location
 ```
 ~/.claude/scripts/
@@ -351,7 +713,95 @@ kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i t
 └── kitty-check.sh       # Verify setup
 ```
 
+## Synchronization Protocol
+
+### Phase Gates
+When a phase BLOCKS other phases, use this mechanism to coordinate parallel Claude instances:
+
+#### 1. Add PHASE GATES Section to Plan
+```markdown
+## 🚦 PHASE GATES
+
+| Gate | Blocking Phase | Waiting Phases | Status | Unlocked By |
+|------|----------------|----------------|--------|-------------|
+| GATE-1 | Phase 0 (Safety) | Phase 1A, 1B, 1C | 🔴 LOCKED | CLAUDE 2 |
+| GATE-2 | Phase 1 (All) | Phase 2 | 🔴 LOCKED | CLAUDE 1 |
+```
+
+#### 2. Gate Status Values
+- 🔴 LOCKED - Waiting phases cannot start
+- 🟢 UNLOCKED - Waiting phases can proceed
+
+#### 3. Unlock Protocol (for Claude completing blocking phase)
+When ALL tasks in the blocking phase are ✅:
+1. Update plan file - change gate status from 🔴 LOCKED to 🟢 UNLOCKED
+2. Notify waiting Claude instances:
+```bash
+kitty @ send-text --match title:Claude-3 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now." && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now." && kitty @ send-key --match title:Claude-4 Return
+```
+
+#### 4. Polling Protocol (for waiting Claude instances)
+```bash
+# Check gate status every 5 minutes:
+grep "GATE-1" [plan_path] | grep -q "🟢 UNLOCKED" && echo "GO!" || echo "Still waiting..."
+
+# Full polling loop (run in background):
+while ! grep "GATE-1" [plan_path] | grep -q "🟢 UNLOCKED"; do
+  echo "$(date): Waiting for GATE-1..."
+  sleep 300  # 5 minutes
+done
+echo "🟢 GATE-1 UNLOCKED! Starting work..."
+```
+
+### Coordinator Responsibilities (CLAUDE 1)
+
+```
+CLAUDE 1 MUST:
+1. Monitor all gates every 10 minutes
+2. Verify gate unlocks are legitimate (all tasks ✅)
+3. If a Claude forgets to unlock, do it for them
+4. Track elapsed time per phase
+5. Alert if a phase takes >2x estimated time
+```
+
+### Plan Template Addition
+
+Add this to every plan with blocking phases:
+
+```markdown
+## 🚦 PHASE GATES
+
+| Gate | Blocks | Unlocks | Status | Unlocked At |
+|------|--------|---------|--------|-------------|
+| GATE-0 | Phase 0 | Phase 1A, 1B, 1C | 🔴 LOCKED | |
+
+### Gate Instructions
+
+**CLAUDE completing blocking phase**:
+After your last task is ✅, update the gate status above to 🟢 UNLOCKED and run:
+\`\`\`bash
+kitty @ send-text --match title:Claude-3 "🟢 GATE UNLOCKED! Proceed." && kitty @ send-key --match title:Claude-3 Return
+kitty @ send-text --match title:Claude-4 "🟢 GATE UNLOCKED! Proceed." && kitty @ send-key --match title:Claude-4 Return
+\`\`\`
+
+**CLAUDE waiting for gate**:
+Poll every 5 min OR wait for kitty notification:
+\`\`\`bash
+watch -n 300 'grep "GATE-0" plan.md'
+\`\`\`
+```
+
 ## Changelog
 
+- **1.5.0** (2025-12-30): Added mandatory GIT WORKFLOW section with worktrees per Claude, PR per phase, and cleanup protocol
+- **1.4.0** (2025-12-29): Expanded to full Inter-Claude Communication Protocol with bidirectional messaging, worker-to-worker sync, broadcast patterns, message format conventions, and emoji reference table
+- **1.3.5** (2025-12-29): Simplified kitty pattern with `&&` chaining, added Coordinator Communication Pattern section
+- **1.3.4** (2025-12-29): Fixed kitty commands: use `send-text` + `send-key Return` instead of `\r`
+- **1.3.3** (2025-12-29): Added ISE Engineering Fundamentals requirement with link to Microsoft playbook
+- **1.3.2** (2025-12-29): Added mandatory WAVE FINAL documentation tasks and Documentation Rules in NON-NEGOTIABLE section
+- **1.3.1** (2025-12-29): Fixed kitty send-text commands missing `\r` (Enter key) for auto-execution
+- **1.3.0** (2025-12-29): Replaced ASCII box dashboard with clean Markdown tables, added elapsed time tracking per wave
+- **1.2.0** (2025-12-29): Added Synchronization Protocol with Phase Gates for multi-Claude coordination
 - **1.1.0** (2025-12-28): Added Kitty parallel orchestration support
 - **1.0.0** (2025-12-15): Initial security framework and model optimization

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myconvergio",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Enterprise Agent Suite: 57 specialized AI agents for strategy, development, compliance, and operations - Claude Code Plugin",
   "keywords": [
     "claude",