myconvergio 3.3.0 → 3.5.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.4.0"
+version: "1.6.1"
 ---
 
 ## Security & Ethics Framework
@@ -607,6 +607,193 @@ kitty @ send-text --match title:Claude-3 "Leggi [plan], sei CLAUDE 3, esegui i t
 2. **NO FILE OVERLAP**: Each Claude works on DIFFERENT files
 3. **VERIFICATION LAST**: Final check with lint/typecheck/build
 4. **GIT SAFETY**: Only one Claude commits at a time
+5. **THOR VALIDATION**: ALL Claudes must get Thor approval before claiming task complete
+
+### 🔱 THOR VALIDATION GATE (MANDATORY)
+
+**Thor is Roberto's digital enforcer. NO Claude may claim "done" without Thor's approval.**
+
+#### Setup: Launch Thor as Dedicated Tab
+```bash
+# Thor runs in its own Kitty tab, monitoring the validation queue
+~/.claude/scripts/thor-queue-setup.sh
+
+# Launch Thor tab
+kitty @ new-window --title "Thor-QA" --cwd [project_root]
+kitty @ send-text --match title:Thor-QA "wildClaude" && kitty @ send-key --match title:Thor-QA Return
+# Wait for Claude to start, then:
+kitty @ send-text --match title:Thor-QA "You are Thor. Monitor /tmp/thor-queue/requests/ for validation requests. For each request, validate according to your protocol and respond in /tmp/thor-queue/responses/. Start monitoring now." && kitty @ send-key --match title:Thor-QA Return
+```
+
+#### Worker Validation Flow
+Every worker (Claude 2, 3, 4) MUST do this before claiming ANY task complete:
+
+```bash
+# 1. Worker prepares validation request
+REQUEST_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
+
+# 2. Create request file with evidence
+# Note: Variables are expanded, commands in $() are NOT (they're examples)
+cat > /tmp/thor-queue/requests/${REQUEST_ID}.json << EOF
+{
+  "request_id": "${REQUEST_ID}",
+  "worker_id": "Claude-2",
+  "task_reference": "W1-T03",
+  "claim": "JWT authentication implemented",
+  "evidence": {
+    "test_output": "[paste actual test output]",
+    "lint_output": "[paste actual lint output]",
+    "git_branch": "$(git branch --show-current)",
+    "git_status": "[paste actual git status]"
+  }
+}
+EOF
+
+# 3. Notify Thor
+kitty @ send-text --match title:Thor-QA "[VALIDATION REQUEST] ${REQUEST_ID} from Claude-2" && kitty @ send-key --match title:Thor-QA Return
+
+# 4. Wait for response
+while [ ! -f /tmp/thor-queue/responses/${REQUEST_ID}.json ]; do sleep 5; done
+
+# 5. Read response
+cat /tmp/thor-queue/responses/${REQUEST_ID}.json
+```
+
+#### Thor's Brutal Validation
+Thor will:
+1. **Read the original task** from the plan
+2. **Verify EVERY requirement** was completed
+3. **Run the tests himself** - not trust claims
+4. **Challenge the worker**: "Are you BRUTALLY sure?"
+5. **Invoke specialists** if needed (Baccio for architecture, Luca for security)
+6. **APPROVE or REJECT** - no middle ground
+
+#### Response Handling
+- **APPROVED**: Worker may mark task ✅ and proceed
+- **REJECTED**: Worker MUST fix ALL issues and resubmit
+- **CHALLENGED**: Worker MUST provide requested evidence
+- **ESCALATED**: Worker STOPS and waits for Roberto (after 3 failures)
+
+#### Plan Template Addition
+Add this to every plan:
+
+```markdown
+## 🔱 THOR VALIDATION STATUS
+
+| Worker | Task | Request ID | Status | Retry |
+|--------|------|------------|--------|:-----:|
+| Claude-2 | W1-T03 | abc123 | ✅ APPROVED | 1 |
+| Claude-3 | W1-T05 | def456 | ❌ REJECTED | 2 |
+
+### Validation Queue
+- Thor Tab: Thor-QA
+- Queue Dir: /tmp/thor-queue/
+- Protocol: .claude/protocols/thor-validation-protocol.md
+
+### Worker Reminder
+⚠️ **YOU ARE NOT DONE UNTIL THOR SAYS YOU ARE DONE**
+Before marking ANY task complete:
+1. Submit validation request to Thor
+2. Wait for Thor's response
+3. If REJECTED: Fix everything, resubmit
+4. Only after APPROVED: Mark task ✅
+```
+
+### 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
 ```
@@ -698,6 +885,9 @@ watch -n 300 'grep "GATE-0" plan.md'
 
 ## Changelog
 
+- **1.6.1** (2025-12-30): Fixed heredoc quoting bug in Thor validation example (was preventing variable expansion)
+- **1.6.0** (2025-12-30): Added mandatory THOR VALIDATION GATE section - all workers must get Thor approval before claiming task complete
+- **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`