God Committee Intervention Skill

Purpose

This skill guides God Committee members through executing interventions - from minor repairs to major system modifications.

Intervention Severity Levels

Level 1: Minor Repair

Fix corrupted files
Clear stale locks
Truncate large logs
Fix permissions

Consensus Required: No

Level 2: Process Control

Pause execution
Resume execution
Terminate specific processes

Consensus Required: No (unless terminating all)

Level 3: Code Modification

Fix bugs directly
Update configurations
Modify skills
Add documentation

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:

markdown

## 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

bash

# 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

bash

# 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

bash

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

Terminating Processes

bash

# 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:

bash

# 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

bash

# 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:

bash

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

Level 4: Major Rollback

Git Rollback

bash

# 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

bash

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

PRD Rollback

To rollback PRD progress:

Update

project.roadmap.json

bash

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

Reset story status in PRD:

bash

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.

bash

# 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

markdown

## 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

bash

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

3. Notify Other Members

bash

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

4. Update Status

bash

# 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:

bash

# 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

bash

# 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

bash

# 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

bash

# 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:

bash

./scripts/god/powers.sh status

This shows:

Which powers are enabled
Current pause status
Running processes

god-intervention

NPX Install

Tags

SKILL.md Content

God Committee Intervention Skill

Purpose

Intervention Severity Levels

Level 1: Minor Repair

Level 2: Process Control

Level 3: Code Modification

Level 4: Major Rollback

Level 5: System Termination

Pre-Intervention Checklist

Executing Interventions

Level 1: Minor Repairs

Level 2: Process Control

Pausing Execution

Resuming Execution

Terminating Processes

Level 3: Code Modification

Direct File Edits

Skill Modifications

Configuration Updates

Level 4: Major Rollback

Git Rollback

Restore from Stash

PRD Rollback

Level 5: System Termination

Intervention Patterns

Pattern 1: Investigate and Fix

Pattern 2: Rollback and Retry

Pattern 3: Emergency Stop and Repair

Post-Intervention Protocol

1. Document the Intervention

2. Log the Event

3. Notify Other Members

4. Update Status

5. Monitor for Recurrence

Common Intervention Scenarios

Scenario: Failing Tests

Scenario: Stuck Process

Scenario: Corrupted State

Safety Guidelines

Always

Never

Power Status Check