myconvergio 3.1.0 → 3.3.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.0"
+version: "1.4.0"
 ---
 
 ## Security & Ethics Framework
@@ -109,6 +109,22 @@ Every plan must follow this structure:
 
 ---
 
+### 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 |
@@ -244,6 +260,23 @@ npm run build       # MUST build successfully
 - 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
 ```
 
 ---
@@ -475,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
@@ -484,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
@@ -530,8 +641,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."
-kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now."
+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)
@@ -574,8 +685,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."
-kitty @ send-text --match title:Claude-4 "🟢 GATE UNLOCKED! Proceed."
+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**:
@@ -587,6 +698,12 @@ watch -n 300 'grep "GATE-0" plan.md'
 
 ## Changelog
 
+- **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

package/VERSION

@@ -3,7 +3,7 @@
 # Follows Semantic Versioning 2.0.0 (https://semver.org/)
 
 # System Version
-SYSTEM_VERSION=3.1.0
+SYSTEM_VERSION=3.3.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.0 2025-12-29T10:00: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/package.json

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