God Intervention

Consensus Required: Recommended

Level 4: Major Rollback

• Revert multiple commits
• Undo PRD progress
• Reset system state

Consensus Required: Yes

Level 5: System Termination

• Stop all execution
• Archive project state
• Full system shutdown

Consensus Required: Yes

Pre-Intervention Checklist

Before any intervention:

## Pre-Intervention Checklist

- [ ] Issue clearly identified and documented
- [ ] Evidence gathered (logs, metrics, observations)
- [ ] Impact assessment completed
- [ ] Rollback plan prepared
- [ ] Consensus obtained (if required)
- [ ] Execution layer paused (if needed)
- [ ] Backup created (if applicable)

Executing Interventions

Level 1: Minor Repairs

# Clear stale locks
./scripts/god/powers.sh repair lock

# Clean up worktrees
./scripts/god/powers.sh repair worktrees

# Fix corrupted JSON files
./scripts/god/powers.sh repair json

# Truncate large logs
./scripts/god/powers.sh repair logs

# Fix script permissions
./scripts/god/powers.sh repair permissions

# Clean git state
./scripts/god/powers.sh repair git

# Run all repairs
./scripts/god/powers.sh repair all

Level 2: Process Control

Pausing Execution

# Pause with reason
./scripts/god/powers.sh pause "Investigation needed: failing tests" YOUR_ID

# Check pause status
./scripts/god/powers.sh pause-status

Resuming Execution

# Resume execution
./scripts/god/powers.sh resume YOUR_ID

Terminating Processes

# Terminate orchestrator
./scripts/god/powers.sh terminate orchestrator YOUR_ID

# Terminate Aha Loop execution
./scripts/god/powers.sh terminate aha-loop YOUR_ID

# Terminate parallel explorer
./scripts/god/powers.sh terminate explorer YOUR_ID

# Terminate specific PID
./scripts/god/powers.sh terminate pid:12345 YOUR_ID

# Force kill (if terminate fails)
./scripts/god/powers.sh kill orchestrator YOUR_ID

Level 3: Code Modification

Direct File Edits

For simple modifications:

# Append to file
./scripts/god/powers.sh modify "path/to/file" append "content" YOUR_ID

# Prepend to file
./scripts/god/powers.sh modify "path/to/file" prepend "content" YOUR_ID

# Replace file contents
./scripts/god/powers.sh modify "path/to/file" replace "new content" YOUR_ID

For complex edits, use your AI capabilities to directly edit files.

Skill Modifications

# Disable a skill
./scripts/god/powers.sh modify-skill skill-name disable YOUR_ID

# Re-enable a skill
./scripts/god/powers.sh modify-skill skill-name enable YOUR_ID

Configuration Updates

Edit .god/config.json or project configurations directly:

# Example: Update quorum
jq '.council.quorum = 3' .god/config.json > tmp && mv tmp .god/config.json

Level 4: Major Rollback

Git Rollback

# Soft reset (keep changes staged)
./scripts/god/powers.sh rollback HEAD~3 soft YOUR_ID

# Mixed reset (keep changes unstaged)
./scripts/god/powers.sh rollback HEAD~3 mixed YOUR_ID

# Hard reset (discard all changes)
./scripts/god/powers.sh rollback HEAD~3 hard YOUR_ID

# Rollback to specific commit
./scripts/god/powers.sh rollback abc123 soft YOUR_ID

Restore from Stash

./scripts/god/powers.sh restore-stash YOUR_ID

PRD Rollback

To rollback PRD progress:

1. Update project.roadmap.json:

   jq '.prds |= map(if .id == "prd-xxx" then .status = "pending" else . end)' \
     project.roadmap.json > tmp && mv tmp project.roadmap.json
   

2. Reset story status in PRD:

   jq '.stories |= map(.status = "pending")' \
     docs/prd/xxx/prd.json > tmp && mv tmp docs/prd/xxx/prd.json
   

Level 5: System Termination

⚠️ This requires consensus and should be rare.

# Step 1: Pause everything
./scripts/god/powers.sh pause "System termination initiated" YOUR_ID

# Step 2: Terminate all processes
./scripts/god/powers.sh terminate all YOUR_ID

# Step 3: Stop awakener daemon
./scripts/god/awakener.sh stop

# Step 4: Create final state snapshot
./scripts/god/observer.sh snapshot
./scripts/god/observer.sh report

# Step 5: Archive (optional)
git tag -a "god-committee-termination-$(date +%Y%m%d)" -m "System terminated by God Committee"

# Step 6: Log final entry
./scripts/god/observer.sh event "termination" "System terminated by God Committee"

Intervention Patterns

Pattern 1: Investigate and Fix

1. Pause execution
2. Take snapshot
3. Investigate issue
4. Fix the problem
5. Verify fix
6. Resume execution
7. Monitor for recurrence

Pattern 2: Rollback and Retry

1. Pause execution
2. Take snapshot
3. Identify rollback point
4. Execute rollback
5. Clear any bad state
6. Modify approach if needed
7. Resume execution

Pattern 3: Emergency Stop and Repair

1. Terminate offending process immediately
2. Take snapshot
3. Assess damage
4. Run repairs
5. Notify other members
6. Plan recovery
7. Execute recovery
8. Resume with monitoring

Post-Intervention Protocol

After any intervention:

1. Document the Intervention

## Intervention Report

### Intervention ID
int-[timestamp]

### Type
[repair|process_control|code_modification|rollback|termination]

### Severity
[1-5]

### Triggered By
[observation|alert|proposal|emergency]

### Description
[What was done]

### Reason
[Why it was necessary]

### Steps Taken
1. [Step 1]
2. [Step 2]
3. ...

### Outcome
[Success/Partial/Failed]

### Side Effects
[Any unintended consequences]

### Follow-up Required
[Yes/No - if yes, what]

### Lessons Learned
[What we learned]

2. Log the Event

./scripts/god/observer.sh event "intervention" "DESCRIPTION"

3. Notify Other Members

./scripts/god/council.sh send YOUR_ID "other,members" "directive" \
  "Intervention Completed" "SUMMARY"

4. Update Status

# Check intervention history
./scripts/god/powers.sh history interventions 10

# Review repair history
./scripts/god/powers.sh history repairs 10

5. Monitor for Recurrence

Set up a follow-up observation:

# Trigger immediate observation
./scripts/god/awakener.sh random

# Or use a scheduled check type
./scripts/god/awakener.sh scheduled daily

Common Intervention Scenarios

Scenario: Failing Tests

# 1. Check current state
./scripts/god/observer.sh check

# 2. Pause if needed
./scripts/god/powers.sh pause "Investigating test failures"

# 3. Analyze failures
cat test-results.json | jq '.failures'

# 4. Decide action:
#    - Minor fix: edit directly
#    - Major issue: rollback
#    - Need discussion: create proposal

# 5. Execute fix/rollback

# 6. Verify
npm test  # or equivalent

# 7. Resume
./scripts/god/powers.sh resume

Scenario: Stuck Process

# 1. Identify stuck process
ps aux | grep -E "(aha-loop.sh|orchestrator|explorer)"

# 2. Check how long it's been running
# 3. Check for output/progress

# 4. If stuck, terminate
./scripts/god/powers.sh terminate pid:XXXXX

# 5. Clean up any locks
./scripts/god/powers.sh repair lock

# 6. Restart if appropriate
./scripts/aha-loop/orchestrator.sh --continue

Scenario: Corrupted State

# 1. Stop everything
./scripts/god/powers.sh pause "Corrupted state detected"
./scripts/god/powers.sh terminate all

# 2. Assess damage
./scripts/god/powers.sh repair json  # Check for JSON issues
git status  # Check git state

# 3. Decide rollback point
git log --oneline -20

# 4. Execute rollback
./scripts/god/powers.sh rollback COMMIT_HASH hard

# 5. Run repairs
./scripts/god/powers.sh repair all

# 6. Verify
./scripts/god/observer.sh check

# 7. Resume
./scripts/god/powers.sh resume

Safety Guidelines

Always

• ✅ Document before acting
• ✅ Take snapshots before major changes
• ✅ Verify after intervention
• ✅ Notify other members of significant actions
• ✅ Have a rollback plan

Never

• ❌ Make major rollbacks without consensus
• ❌ Terminate system without documentation
• ❌ Skip verification after fixes
• ❌ Hide interventions from other members
• ❌ Assume fixes worked without testing

Power Status Check

Before intervention, verify your powers:

./scripts/god/powers.sh status

This shows:

• Which powers are enabled
• Current pause status
• Running processes