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:

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:

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

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