Files
agentic-govbot/constitution.md
Nathan Schneider fbc37ecb8f Initial commit: Platform-agnostic governance bot
Govbot is an AI-powered governance bot that interprets natural language
constitutions and facilitates collective decision-making across social
platforms.

Core features:
- Agentic architecture with constitutional reasoning (RAG)
- Platform-agnostic design (Mastodon, Discord, Telegram, etc.)
- Action primitives for flexible governance processes
- Temporal awareness for multi-day proposals and voting
- Audit trail with constitutional citations
- Reversible actions with supermajority veto
- Works with local (Ollama) and cloud AI models

Platform support:
- Mastodon: Full implementation with streaming, moderation, and admin skills
- Discord/Telegram: Platform abstraction ready for implementation

Documentation:
- README.md: Architecture and overview
- QUICKSTART.md: Getting started guide
- PLATFORMS.md: Platform implementation guide for developers
- MASTODON_SETUP.md: Complete Mastodon deployment guide
- constitution.md: Example governance constitution

Technical stack:
- Python 3.11+
- SQLAlchemy for state management
- llm CLI for model abstraction
- Mastodon.py for Mastodon integration
- Pydantic for configuration validation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-06 17:09:26 -07:00

6.8 KiB

Governance Constitution

This constitution defines how collective governance operates within this Mastodon instance.

Article 1: Governance Bot

Section 1.1: Bot Authority

The governance bot (@govbot) facilitates democratic decision-making according to this constitution. All bot actions must cite constitutional authority and are subject to member oversight.

Section 1.2: Audit and Oversight

  • All bot actions are logged with constitutional reasoning
  • Members can review the audit log at any time
  • Any action can be challenged through the appeal process (Article 6)

Section 1.3: Emergency Halt

If the bot acts contrary to this constitution's spirit, any member may call for an emergency review. A supermajority (2/3) vote can immediately halt or reverse bot actions.

Article 2: Membership and Rights

Section 2.1: Member Rights

All instance members have equal rights to:

  • Propose governance changes
  • Vote on proposals
  • Access governance records
  • Appeal bot decisions
  • Request constitutional interpretation

Section 2.2: Member Responsibilities

Members are expected to:

  • Participate in good faith
  • Follow the code of conduct
  • Review governance proposals when feasible

Article 3: Proposals

Section 3.1: Proposal Types

Standard Proposals address routine governance matters:

  • Discussion period: 6 days minimum
  • Passage threshold: More Agree than Disagree votes
  • Abstentions do not count against passage

Urgent Proposals address time-sensitive matters:

  • Must be labeled "URGENT" with justification
  • Discussion period: 2 days minimum
  • Passage threshold: Same as standard proposals
  • Any member may challenge urgency designation

Constitutional Amendments modify this constitution:

  • Discussion period: 10 days minimum
  • Passage threshold: At least 3 times as many Agree as Disagree votes
  • Higher bar reflects importance of constitutional stability

Section 3.2: Proposal Creation

Any member may create a proposal by:

  1. Mentioning @govbot with proposal text
  2. Specifying proposal type if not standard
  3. Providing rationale and context

The bot will:

  • Confirm receipt and proposal type
  • Set appropriate deadline based on type
  • Open discussion thread
  • Track votes
  • Announce result when deadline passes

Section 3.3: Block Votes

Members may cast a Block vote to signal fundamental disagreement (e.g., ethical concerns, constitutional violations).

For proposals with Blocks to pass:

  • Require at least 9 times more Agree votes than combined Disagree and Block votes
  • Block votes should include explanation of fundamental concern
  • Overriding blocks requires strong consensus

Article 4: Voting

Section 4.1: Vote Types

  • Agree: Support the proposal
  • Disagree: Oppose the proposal
  • Abstain: Counted for quorum but not in thresholds
  • Block: Fundamental disagreement (see Article 3.3)

Section 4.2: Voting Process

  • Members vote by replying to proposal thread
  • Votes can be changed before deadline
  • Bot tracks and counts votes automatically
  • Final tally posted when deadline passes

Section 4.3: Vote Privacy

Votes are public by default (visible in threads). This promotes transparency and accountability.

Article 5: Administrative Actions

Section 5.1: Code of Conduct Changes

Changes to the instance Code of Conduct:

  • Require constitutional amendment process (10 days, 3x threshold)
  • Bot can update CoC text upon passage
  • Previous version archived for reference

Section 5.2: Moderation Actions

Emergency moderation (spam, harassment, illegal content):

  • Any moderator can take immediate action
  • Action must be reported to community within 24 hours
  • Community can review and reverse through standard proposal
  • Bot can execute moderation actions when authorized

Section 5.3: Admin Powers

Administrative access (server configuration, user roles):

  • Changes require standard proposal
  • Bot can transfer admin powers when authorized
  • Maintains audit log of all admin actions

Section 5.4: Instance Policies

Changes to instance policies (federation, content warnings, etc.):

  • Require standard proposal process
  • Bot implements approved policy changes
  • Policy history maintained

Article 6: Appeals and Clarification

Section 6.1: Constitutional Interpretation

Members may ask the bot to interpret constitutional provisions:

  • Bot provides interpretation with reasoning
  • Non-binding but serves as guidance
  • Community can override through constitutional amendment

Section 6.2: Ambiguity Resolution

If the bot encounters serious constitutional ambiguity:

  • Bot posts question seeking clarification
  • Community discusses and provides guidance
  • May result in constitutional amendment for clarity

Section 6.3: Appeal Process

To appeal a bot action or interpretation:

  1. Member posts appeal with reasoning
  2. Community discusses (3 day minimum)
  3. Standard proposal vote on override
  4. Supermajority (2/3) can immediately halt pending appeals

Article 7: Precedent and Evolution

Section 7.1: Governance Precedent

Bot maintains record of:

  • All proposals and outcomes
  • Constitutional interpretations
  • Clarifications provided
  • Appeals and resolutions

These create guidance for future similar cases.

Section 7.2: Constitutional Amendments

This constitution can be amended through the constitutional amendment process (Article 3.1). Amendments should maintain:

  • Democratic principles
  • Member rights and protections
  • Audit and oversight mechanisms
  • Appeal processes

Section 7.3: Emergency Provisions

In case of bot malfunction or constitutional crisis:

  • Instance admin retains ultimate technical control
  • Community can coordinate emergency response
  • Constitutional amendments can establish recovery procedures

Article 8: Temporal Governance

Section 8.1: Deadlines and Timing

  • All time periods measured in calendar days
  • Deadlines posted in UTC with local time conversions
  • Bot sends reminders before deadlines
  • Extensions require proposal and approval

Section 8.2: Quorum

No quorum required for proposals to pass (to avoid voter fatigue). High thresholds (3x, 9x) serve similar function.

Section 8.3: Concurrent Processes

Multiple governance processes can run simultaneously. Bot tracks each independently.


Implementation Notes

This constitution is designed to be interpreted by an AI agent. Key principles:

  1. Flexibility: Specific procedures may vary as long as they honor constitutional principles
  2. Transparency: All bot actions must be explainable and auditable
  3. Reversibility: Governance is iterative; decisions can be reconsidered
  4. Good Faith: Members and bot operate with assumption of good intentions
  5. Safety: Multiple mechanisms prevent bot malfunction or misuse

The bot should seek to honor the spirit of this constitution, not just its letter. When in doubt, prioritize member autonomy, transparency, and democratic values.