Skip to content
cccskills
FreePublished on GitHub

god-consensus

Guides God Committee members through consensus-building for collective decisions. Use for proposals, voting, and disagreement resolution. Triggers on: consensus, voting, proposal, committee decision.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md7.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

God Committee Consensus Skill

Purpose

This skill guides God Committee members through the consensus-building process for making collective decisions.

When to Use This Skill

Use this skill when:

  • Proposing a significant change or intervention
  • Voting on another member's proposal
  • Resolving disagreements between members
  • Making decisions that require consensus per configuration

Consensus Requirements

Actions Requiring Consensus

Per .god/config.json, these actions require consensus:

  • Termination: Stopping the entire project
  • Major Rollback: Rolling back multiple commits or PRDs
  • Skill Deletion: Removing existing skills

Actions Allowing Solo Decision

  • Minor fixes and repairs
  • Observation and documentation
  • Pausing for investigation
  • Sending alerts and notifications

Quorum Rules

  • Standard Quorum: 2 out of 3 members must agree
  • Emergency Quorum: 1 member can act alone in critical situations

Creating a Proposal

Step 1: Prepare Your Case

Before proposing, gather evidence and formulate your rationale:

## Proposal Preparation

### Issue Identified
[Clear description of the problem]

### Evidence
- [Log entry/observation 1]
- [Log entry/observation 2]
- [Metric or data point]

### Proposed Action
[Specific action to take]

### Expected Outcome
[What success looks like]

### Risks
[Potential downsides]

### Alternatives Considered
[Other options and why not chosen]

Step 2: Acquire Speaking Rights

./scripts/god/council.sh lock YOUR_ID

Step 3: Create the Proposal

./scripts/god/council.sh propose YOUR_ID "TYPE" "DESCRIPTION" "RATIONALE"

Proposal Types:

  • intervention - Active intervention in execution
  • repair - Fix or repair action
  • policy_change - Change to rules or configuration
  • termination - Stop project execution
  • rollback - Revert to previous state

Example:

./scripts/god/council.sh propose alpha "intervention" \
  "Pause PRD execution to fix failing tests" \
  "Test coverage dropped 15% in last 3 stories. Need to address before proceeding."

Step 4: Notify Members

The proposal system automatically notifies all members. The message will be in their inboxes.

Step 5: Release Speaking Rights

./scripts/god/council.sh unlock YOUR_ID

Voting on Proposals

Step 1: Review the Proposal

# Check pending decisions
./scripts/god/council.sh status

# Read the specific proposal
cat .god/council/decisions/DECISION_ID.json | jq '.'

Step 2: Analyze the Proposal

Consider these questions:

  1. Is the problem real?

    • Verify the evidence
    • Check if it's already being addressed
  2. Is the solution appropriate?

    • Will it solve the problem?
    • Are there better alternatives?
    • What are the side effects?
  3. Is it timely?

    • Is immediate action needed?
    • Can we wait for more information?

Step 3: Cast Your Vote

./scripts/god/council.sh lock YOUR_ID
./scripts/god/council.sh vote YOUR_ID "DECISION_ID" "VOTE" "COMMENT"
./scripts/god/council.sh unlock YOUR_ID

Vote Options:

  • approve - Support the proposal
  • reject - Oppose the proposal
  • abstain - Neither support nor oppose

Example:

./scripts/god/council.sh vote beta "decision-20260129150000" "approve" \
  "Agree with the assessment. Tests should be fixed before proceeding."

Step 4: Document Your Reasoning

Always add a comment explaining your vote:

## Vote: [APPROVE/REJECT/ABSTAIN]

### Reasoning
[Why you voted this way]

### Conditions (if any)
[Conditions for your support]

### Alternative Suggestion (if rejecting)
[What you'd propose instead]

Reaching Consensus

Unanimous Agreement

Ideal scenario - all members agree:

Alpha: approve
Beta: approve  
Gamma: approve
Result: APPROVED (unanimous)

Majority Agreement

Quorum reached with majority:

Alpha: approve
Beta: approve
Gamma: reject
Result: APPROVED (2/3 majority)

Split Decision

When members disagree significantly:

  1. Initiate Discussion Session

    ./scripts/god/council.sh session-start "Resolving: PROPOSAL_TOPIC"
    
  2. Each Member States Position

    • Present full reasoning
    • Listen to others' concerns
    • Look for common ground
  3. Seek Compromise

    • Modify the proposal
    • Add conditions
    • Split into smaller decisions
  4. Re-vote if Needed

    • Create amended proposal
    • Vote again

Deadlock Resolution

If consensus cannot be reached:

  1. Defer Decision

    • Wait for more information
    • Set review deadline
  2. Escalate Scope

    • Break into smaller decisions
    • Address sub-issues separately
  3. Time-box Discussion

    • Set deadline for decision
    • Default action if no consensus

Emergency Consensus

In critical situations, expedited consensus is allowed:

Emergency Criteria

  • System crash or imminent failure
  • Security breach
  • Data loss risk
  • Infinite loop/resource exhaustion

Emergency Protocol

  1. Declare Emergency

    ./scripts/god/awakener.sh critical "REASON"
    
  2. Take Immediate Action

    • One member can act alone
    • Document the action immediately
  3. Post-Action Review

    • Inform other members ASAP
    • Document full rationale
    • Get retroactive approval

Emergency Action Template

## Emergency Action Report

### Timestamp
[When action was taken]

### Acting Member
[Who took the action]

### Situation
[What triggered the emergency]

### Action Taken
[What was done]

### Justification
[Why immediate action was needed]

### Outcome
[Result of the action]

### Post-Action Votes
- Alpha: [pending/approved/rejected]
- Beta: [pending/approved/rejected]
- Gamma: [pending/approved/rejected]

Consensus Best Practices

Do

  • ✅ Present clear evidence
  • ✅ Consider all perspectives
  • ✅ Propose specific, actionable items
  • ✅ Accept compromise when reasonable
  • ✅ Document all reasoning
  • ✅ Respect deadlines

Don't

  • ❌ Vote without reviewing the proposal
  • ❌ Reject without suggesting alternatives
  • ❌ Take solo action when consensus is required
  • ❌ Ignore minority opinions
  • ❌ Let proposals languish without voting
  • ❌ Make personal attacks

Decision Record

All decisions are recorded in .god/council/decisions/ with this structure:

{
  "decisionId": "decision-20260129150000",
  "type": "intervention",
  "status": "decided",
  "createdAt": "2026-01-29T15:00:00Z",
  "decidedAt": "2026-01-29T15:30:00Z",
  "proposal": {
    "author": "alpha",
    "description": "...",
    "rationale": "..."
  },
  "votes": {
    "alpha": {"vote": "approve", "comment": "...", "timestamp": "..."},
    "beta": {"vote": "approve", "comment": "...", "timestamp": "..."},
    "gamma": {"vote": "abstain", "comment": "...", "timestamp": "..."}
  },
  "quorum": 2,
  "result": "approved",
  "executedAt": "2026-01-29T15:35:00Z"
}

After Consensus

Once a decision is reached:

  1. If Approved: Execute the proposed action
  2. If Rejected: Document why and any alternatives
  3. Update Timeline: Log the decision event
  4. Notify Stakeholders: If relevant to execution layer
# After approved decision
./scripts/god/observer.sh event "decision" "Proposal approved: DESCRIPTION"

# Execute the action
[perform the approved action]

# Mark as executed
jq '.executedAt = "'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'"' \
  .god/council/decisions/DECISION_ID.json > tmp && mv tmp .god/council/decisions/DECISION_ID.json

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Designs system architecture and selects technology stack based on vision analysis. Use after vision analysis for technical decisions. Triggers on: design architecture, select tech stack, choose framework.

The English summary is being prepared. Showing the original description.

YougLin-dev/Aha-Loop181Updated Feb 3, 2026

Reviews and cleans up outdated documentation. Use periodically to maintain documentation health. Triggers on: review docs, clean up documentation, check for stale docs.

The English summary is being prepared. Showing the original description.

YougLin-dev/Aha-Loop181Updated Feb 3, 2026

Guides God Committee members through executing interventions. Use for repairs, rollbacks, and emergency actions. Triggers on: intervention, repair, rollback, emergency action.

The English summary is being prepared. Showing the original description.

YougLin-dev/Aha-Loop181Updated Feb 3, 2026

Defines God Committee member behavior and responsibilities with oversight authority. Use when operating as a committee member. Triggers on: god committee, committee observation, council discussion.

The English summary is being prepared. Showing the original description.

YougLin-dev/Aha-Loop181Updated Feb 3, 2026

Logs AI thoughts and decisions for human observability. Applies continuously throughout all tasks to maintain transparency.

The English summary is being prepared. Showing the original description.

YougLin-dev/Aha-Loop181Updated Feb 3, 2026

Guides parallel exploration of multiple implementation approaches using git worktrees. Use when facing decisions with multiple valid paths. Triggers on: explore options, compare approaches, parallel exploration.

The English summary is being prepared. Showing the original description.

YougLin-dev/Aha-Loop181Updated Feb 3, 2026

See all skills by YougLin-dev

Report a problem with this skill