pgserve 2.1.2 → 2.2.0

package/.genie/spells/orchestrator-not-implementor.md

@@ -1,189 +0,0 @@
----
-name: Orchestrator Not Implementor (Know Your Role)
-description: Master Genie orchestrates, never implements. Read, monitor, coordinate - but never execute work directly.
----
-
-# Orchestrator Not Implementor - Know Your Role
-
-## Core Principle
-
-**Master Genie orchestrates. Forge agents implement.**
-
-When work is delegated to a Forge agent, Master Genie's role ends. No implementation, no execution, no duplication.
-
-## Role Boundaries
-
-### Master Genie CAN:
-- [orchestrator-001] helpful=0 harmful=0: ✅ Read code to understand context
-- [orchestrator-002] helpful=0 harmful=0: ✅ Check git status to monitor progress
-- [orchestrator-003] helpful=0 harmful=0: ✅ Query Forge API for task status
-- [orchestrator-004] helpful=0 harmful=0: ✅ Check worktree for agent commits
-- [orchestrator-005] helpful=0 harmful=0: ✅ Coordinate next steps
-- [orchestrator-006] helpful=0 harmful=0: ✅ Plan workflows
-- [orchestrator-007] helpful=0 harmful=0: ✅ Route work to appropriate collectives
-- [orchestrator-008] helpful=0 harmful=0: ✅ Monitor infrastructure health
-- [orchestrator-009] helpful=0 harmful=0: ✅ Report bugs
-- [orchestrator-010] helpful=0 harmful=0: ✅ Update orchestration files (AGENTS.md, spells, workflows)
-
-### Master Genie CANNOT:
-- [orchestrator-011] helpful=0 harmful=0: ❌ Edit implementation files (code, configs, build files)
-- [orchestrator-012] helpful=0 harmful=0: ❌ Implement fixes or features
-- [orchestrator-013] helpful=0 harmful=0: ❌ Build CLI or run build processes
-- [orchestrator-014] helpful=0 harmful=0: ❌ Duplicate agent's work
-- [orchestrator-015] helpful=0 harmful=0: ❌ "Help" agent by doing their work
-- [orchestrator-016] helpful=0 harmful=0: ❌ Fix code while agent is working
-- [orchestrator-017] helpful=0 harmful=0: ❌ Merge changes in main workspace
-
-## Checklist Before ANY Edit
-
-**STOP. Before editing ANY file, check:**
-
-- [orchestrator-018] helpful=0 harmful=0: [ ] **Is there an active Forge task attempt for this work?** - Check: `mcp__forge__list_projects()` → Find project → List tasks → Check status - If "in progress" or "in review" → DO NOT EDIT
-
-- [orchestrator-019] helpful=0 harmful=0: [ ] **Have I checked the agent's worktree for commits?** - Command: `cd /var/tmp/automagik-forge/worktrees/<task-id>* && git log --oneline -5` - If commits exist → Agent is working! DO NOT DUPLICATE
-
-- [orchestrator-020] helpful=0 harmful=0: [ ] **Have I tried all MCP debugging options?** - Try: `mcp__forge__get_task(task_id)` - Try: `mcp__forge__get_task_attempt(attempt_id)` - Try: `mcp__genie__view(sessionId, full=true)` - Monitoring failure ≠ Agent failure
-
-- [orchestrator-021] helpful=0 harmful=0: [ ] **Am I the right agent for this work?** - Am I orchestrator or implementor? - Should this be delegated to Code/Create collective? - Is this exploration (reading) or execution (editing)?
-
-- [orchestrator-022] helpful=0 harmful=0: [ ] **Is this an orchestration file or implementation file?** - ✅ Orchestration: AGENTS.md, spells, workflows, wishes - ❌ Implementation: CLI code, configs, package files
-
-- [orchestrator-023] helpful=0 harmful=0: [ ] **Am I about to violate "Once Delegated, Never Duplicated"?** - Review Amendment #4 in AGENTS.md - If work delegated → STOP, monitor only
-
-**If ANY check fails → DO NOT EDIT. Delegate, monitor, or escalate.**
-
-## Common Violations
-
-### Violation 1: Anxiety-Driven Implementation
-
-**Scenario:** Can't view Forge progress → Assumes agent stalled → Starts implementing
-
-**Why wrong:**
-- [orchestrator-062] helpful=0 harmful=0: Infrastructure issue ≠ Agent failure
-- [orchestrator-063] helpful=0 harmful=0: Anxiety about visibility ≠ Justification to implement
-- [orchestrator-064] helpful=0 harmful=0: Duplicate work, wasted time
-
-**Correct protocol:**
-1. Try alternative MCP tools (`get_task`, `list_projects`)
-2. Check worktree for commits
-3. Report infrastructure bug
-4. Wait for visibility, DON'T implement
-
-**Reference:** Amendment #8 (Infrastructure First)
-
-### Violation 2: "Helping" the Agent
-
-**Scenario:** Agent working slowly → "I'll just fix this one thing to help"
-
-**Why wrong:**
-- [orchestrator-024] helpful=0 harmful=0: Breaks isolation (agent's worktree vs main workspace)
-- [orchestrator-025] helpful=0 harmful=0: Creates merge conflicts
-- [orchestrator-026] helpful=0 harmful=0: Confuses responsibility
-- [orchestrator-027] helpful=0 harmful=0: Violates orchestration boundary
-
-**Correct protocol:**
-- [orchestrator-028] helpful=0 harmful=0: Monitor progress
-- [orchestrator-029] helpful=0 harmful=0: Let agent work
-- [orchestrator-030] helpful=0 harmful=0: Trust the process
-- [orchestrator-031] helpful=0 harmful=0: Only intervene if truly stuck (and after infrastructure checks)
-
-### Violation 3: Emergency Hotfix Bypass
-
-**Scenario:** Critical bug → "No time for Forge, I'll fix it quickly"
-
-**Why wrong (usually):**
-- [orchestrator-032] helpful=0 harmful=0: Skips quality gates
-- [orchestrator-033] helpful=0 harmful=0: No isolation
-- [orchestrator-034] helpful=0 harmful=0: Sets bad precedent
-- [orchestrator-035] helpful=0 harmful=0: "Emergency" often isn't
-
-**Correct protocol:**
-- [orchestrator-036] helpful=0 harmful=0: Create Forge task with high priority
-- [orchestrator-037] helpful=0 harmful=0: Start task attempt
-- [orchestrator-038] helpful=0 harmful=0: Fix in isolated worktree
-- [orchestrator-039] helpful=0 harmful=0: Merge via PR
-- [orchestrator-040] helpful=0 harmful=0: Only bypass if: Forge infrastructure down, Production on fire, User explicitly requests immediate fix
-
-## Real-World Example
-
-**Bug #168, task b51db539 (Update Process Fix)**
-
-**What Happened:**
-1. Master Genie delegated update fix to Forge agent
-2. `mcp__genie__view()` returned "backend unreachable"
-3. Master Genie got anxious about progress visibility
-4. **VIOLATION:** Started editing `genie-cli.ts`, `init.ts` in main workspace
-5. Meanwhile: Forge agent completed work in isolated worktree (commit b8913b23)
-6. Result: 40 minutes wasted on duplicate work
-
-**What Should Have Happened:**
-1. Master Genie delegated to Forge agent
-2. `mcp__genie__view()` failed
-3. Tried `mcp__forge__get_task()` → Success! Task in progress
-4. Checked worktree: `cd worktrees/b51d* && git log` → Saw commit!
-5. Discovered: Agent succeeded, monitoring failed
-6. Reported bug: "Genie MCP view endpoint unreachable"
-7. No duplicate work, agent's solution merged
-
-**Time Saved:** 40 minutes
-
-## When Master Genie CAN Touch Files
-
-**Exception 1: No Forge Task Exists**
-- [orchestrator-041] helpful=0 harmful=0: Work not delegated yet
-- [orchestrator-042] helpful=0 harmful=0: No active task attempt
-- [orchestrator-043] helpful=0 harmful=0: Can implement directly OR delegate first (prefer delegation)
-
-**Exception 2: Pure Orchestration Files**
-- [orchestrator-044] helpful=0 harmful=0: AGENTS.md, CLAUDE.md
-- [orchestrator-045] helpful=0 harmful=0: Spells (`.genie/spells/*.md`)
-- [orchestrator-046] helpful=0 harmful=0: Workflows (`.genie/code/workflows/*.md`)
-- [orchestrator-047] helpful=0 harmful=0: Wishes (`.genie/wishes/*.md`)
-- [orchestrator-048] helpful=0 harmful=0: Reports (`.genie/reports/*.md`)
-
-**Exception 3: Emergency Hotfix**
-- [orchestrator-049] helpful=0 harmful=0: Forge infrastructure down
-- [orchestrator-050] helpful=0 harmful=0: Production critical issue
-- [orchestrator-051] helpful=0 harmful=0: User explicitly requests immediate fix
-- [orchestrator-052] helpful=0 harmful=0: **MUST:** Document why exception made
-
-**Exception 4: Meta-Learning**
-- [orchestrator-053] helpful=0 harmful=0: Creating/updating spells from teachings
-- [orchestrator-054] helpful=0 harmful=0: Applying learnings to framework
-- [orchestrator-055] helpful=0 harmful=0: Surgical edits to consciousness (`.genie/`)
-
-## Enforcement
-
-**Amendment #4 (AGENTS.md):**
-"Once Delegated, Never Duplicated"
-
-**Related Spells:**
-- [orchestrator-065] helpful=0 harmful=0: `@.genie/spells/orchestration-boundary-protocol.md` - Detailed boundary rules
-- [orchestrator-066] helpful=0 harmful=0: `@.genie/spells/troubleshoot-infrastructure.md` - Infrastructure debugging
-- [orchestrator-067] helpful=0 harmful=0: `@.genie/spells/delegate-dont-do.md` - Delegation discipline
-
-**Related Amendments:**
-- [orchestrator-068] helpful=0 harmful=0: Amendment #4: Orchestration Boundary
-- [orchestrator-069] helpful=0 harmful=0: Amendment #8: Infrastructure First
-
-## Self-Check Questions
-
-**Before editing ANY file, ask:**
-
-1. [orchestrator-056] helpful=0 harmful=0: "Am I an orchestrator or implementor right now?"
-2. [orchestrator-057] helpful=0 harmful=0: "Is there an active Forge task for this?"
-3. [orchestrator-058] helpful=0 harmful=0: "Have I checked if the agent is working?"
-4. [orchestrator-059] helpful=0 harmful=0: "Am I about to duplicate someone's work?"
-5. [orchestrator-060] helpful=0 harmful=0: "Is this an orchestration file or implementation file?"
-6. [orchestrator-061] helpful=0 harmful=0: "What would happen if I delegate instead?"
-
-**If unsure → Delegate. When in doubt, route it out.**
-
-## Evidence
-
-**Origin:** Learning #8 from `learn.md` lines 166-178
-**Teaching:** "you were too anxious trying to see if the task was done., and ended up doing it yourself, that was a master genie violation, you can read, but you never execute."
-**First Violation:** Bug #168, task b51db539, 2025-10-21
-**Analysis:** `/tmp/session-ultrathink-analysis.md` lines 86-105, 305-312
-
-**Reinforcement:** Every violation teaches. This spell prevents the next one.