myconvergio 3.0.0 → 3.2.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.1.0"
+version: "1.3.3"
 ---
 
 ## 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
@@ -328,9 +516,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
-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"
+# 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"
 
 # Monitor progress
 ~/.claude/scripts/claude-monitor.sh
@@ -351,7 +539,91 @@ 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.\r"
+kitty @ send-text --match title:Claude-4 "🟢 GATE-1 UNLOCKED! Start your Phase 1 tasks now.\r"
+```
+
+#### 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.\r"
+kitty @ send-text --match title:Claude-4 "🟢 GATE UNLOCKED! Proceed.\r"
+\`\`\`
+
+**CLAUDE waiting for gate**:
+Poll every 5 min OR wait for kitty notification:
+\`\`\`bash
+watch -n 300 'grep "GATE-0" plan.md'
+\`\`\`
+```
+
 ## Changelog
 
+- **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/VERSION

@@ -3,7 +3,7 @@
 # Follows Semantic Versioning 2.0.0 (https://semver.org/)
 
 # System Version
-SYSTEM_VERSION=3.0.0
+SYSTEM_VERSION=3.2.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.1.0 2025-12-28T18:00:00Z
+strategic-planner=1.3.3 2025-12-29T15:30:00Z
 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.0.0",
+  "version": "3.2.0",
   "description": "Enterprise Agent Suite: 57 specialized AI agents for strategy, development, compliance, and operations - Claude Code Plugin",
   "keywords": [
     "claude",