This commit completes the transition to a pure LLM-driven agentic governance system with no hard-coded governance logic. Core Architecture Changes: - Add structured memory system (memory.py) for tracking governance processes - Add LLM tools (tools.py) for deterministic operations (math, dates, random) - Add audit trail system (audit.py) for human-readable decision explanations - Add LLM-driven agent (agent_refactored.py) that interprets constitution Documentation: - Add ARCHITECTURE.md describing process-centric design - Add ARCHITECTURE_EXAMPLE.md with complete workflow walkthrough - Update README.md to reflect current LLM-driven architecture - Simplify constitution.md to benevolent dictator model for testing Templates: - Add 8 governance templates (petition, consensus, do-ocracy, jury, etc.) - Add 8 dispute resolution templates - All templates work with generic process-based architecture Key Design Principles: - "Process" is central abstraction (not "proposal") - No hard-coded process types or thresholds - LLM interprets constitution to understand governance rules - Tools ensure correctness for calculations - Complete auditability with reasoning and citations Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
9.5 KiB
Petition Constitution
This constitution establishes direct democracy through member petitions and community-wide voting.
Article 1: Governance Principle
Section 1.1: Direct Democracy
This community governs through direct participation:
- Any member can petition for changes
- All members vote on petitions
- Decisions made collectively by membership
- No intermediary representatives
Section 1.2: Petition Authority
Successful petitions have authority to:
- Create or change policies
- Authorize administrative actions
- Modify community rules
- Allocate resources
- Amend this constitution
Section 1.3: Participation
Governance is accessible to all:
- Low barriers to creating petitions
- Simple, transparent voting
- Clear outcomes and implementation
- Bot facilitates the entire process
Article 2: Membership
Section 2.1: Member Rights
All community members have equal rights to:
- Create petitions
- Vote on all petitions
- Discuss petitions publicly
- Access petition history and outcomes
- Challenge petition implementation
Section 2.2: Membership Requirements
To participate in governance:
- Be an active community member
- Agree to code of conduct
- Voting eligibility after 30 days
- Bot tracks membership status
Section 2.3: Member Responsibilities
Members should:
- Review petitions when feasible
- Vote on matters they care about
- Participate in good faith
- Respect petition outcomes
- Help implement approved changes
Article 3: Creating Petitions
Section 3.1: Petition Process
Any member can create a petition:
- Draft clear proposal text
- Submit to @govbot with "petition" tag
- Include rationale and context
- Specify implementation details
- Bot validates and publishes petition
Section 3.2: Petition Requirements
Valid petitions must:
- State specific change or action
- Explain reasoning and impact
- Be clear and unambiguous
- Identify implementation approach
- Follow community values
Section 3.3: Petition Types
Petitions can address:
Policy Petitions - Changes to community rules and policies
- Voting period: 7 days
- Passage threshold: Simple majority (more Yes than No)
Administrative Petitions - Platform configuration and operations
- Voting period: 7 days
- Passage threshold: Simple majority
Resource Petitions - Budget allocation and spending
- Voting period: 7 days
- Passage threshold: Simple majority
Constitutional Petitions - Amendments to this constitution
- Voting period: 14 days
- Passage threshold: 2/3 supermajority
Urgent Petitions - Time-sensitive matters
- Must justify urgency
- Voting period: 3 days
- Passage threshold: Simple majority
- Can be challenged as non-urgent
Section 3.4: Petition Clarity
Bot reviews petitions for clarity:
- Must be understandable to members
- Question clearly stated
- Implementation feasible
- If unclear, bot requests revision
- Community can also request clarification
Article 4: Petition Discussion
Section 4.1: Discussion Period
Before voting opens:
- Minimum 2-day discussion period
- Petitioner explains and answers questions
- Members discuss pros and cons
- Bot facilitates discussion thread
- Petitioner can revise based on feedback
Section 4.2: Discussion Guidelines
During discussion:
- Focus on substance, not personalities
- Ask clarifying questions
- Suggest improvements
- Identify concerns
- Assume good faith
Section 4.3: Petition Amendments
Petitioner can amend during discussion:
- Clarify language
- Address concerns
- Refine implementation
- Major changes restart discussion period
- Bot tracks amendment history
Article 5: Voting
Section 5.1: Voting Period
After discussion period:
- Bot opens voting
- Voting period based on petition type
- All eligible members can vote
- Votes can be changed before deadline
- Bot sends reminders
Section 5.2: Vote Options
Members can vote:
- Yes - Support the petition
- No - Oppose the petition
- Abstain - Counted for participation tracking but not in passage threshold
Section 5.3: Passage Thresholds
Petitions pass when:
- Simple majority: More Yes than No votes
- Supermajority: At least 2/3 of votes are Yes (constitutional petitions)
- Abstentions don't affect threshold calculation
- Bot calculates and announces results
Section 5.4: No Quorum Requirement
No minimum participation required:
- Petitions can pass with any level of turnout
- Assumes members vote on matters important to them
- High stakes issues naturally draw more voters
Article 6: Petition Results
Section 6.1: Announcing Results
When voting closes:
- Bot tallies votes
- Announces outcome (passed/failed)
- Shows vote breakdown
- Explains next steps
- Archives petition and result
Section 6.2: Implementation Timeline
Approved petitions:
- Implementation begins within 7 days
- Urgent petitions: within 24 hours
- Bot executes authorized actions
- Implementation progress reported
- Completion confirmed
Section 6.3: Failed Petitions
If petition fails:
- Outcome recorded
- Can be resubmitted after 30 days
- Resubmission should address concerns raised
- Or wait for changed circumstances
Article 7: Concurrent Petitions
Section 7.1: Multiple Petitions
Multiple petitions can run simultaneously:
- No limit on active petitions
- Bot tracks each independently
- Members vote on each separately
- Clear labeling prevents confusion
Section 7.2: Conflicting Petitions
If petitions conflict:
- Both can be voted on
- If both pass, later one takes precedence
- Or petition can explicitly supersede earlier one
- Bot identifies potential conflicts
Section 7.3: Related Petitions
For related issues:
- Consider combining into single petition
- Or vote sequentially
- Note relationships in petition text
- Bot helps coordinate related petitions
Article 8: Administrative Actions
Section 8.1: Authorized Actions
Bot implements approved petitions:
- Policy changes
- Moderation actions
- Platform configuration
- User role changes
- Content management
Section 8.2: Action Logging
All actions logged with:
- Petition that authorized action
- Timestamp
- Implementation details
- Who executed (bot or member)
- Reversibility information
Section 8.3: Action Review
Members can review actions:
- Check audit log anytime
- Verify correct implementation
- Report discrepancies
- Petition for correction if needed
Article 9: Emergency Procedures
Section 9.1: Emergency Petitions
For urgent safety/security matters:
- Accelerated process (24-hour total)
- Must clearly justify emergency
- Higher passage threshold (60% Yes)
- Can be challenged as non-emergency
Section 9.2: Emergency Actions Without Petition
For immediate threats:
- Any moderator can act immediately
- Must report action within 6 hours
- Emergency petition created retroactively
- Community votes to ratify or reverse
Section 9.3: Bot Malfunction
If bot acts contrary to petitions:
- Any member can call emergency halt
- Manual override by admin
- Emergency petition to address issue
- Fix implemented before resuming
Article 10: Challenging and Reversing
Section 10.1: Implementation Challenges
To challenge implementation:
- Member submits challenge to @govbot
- Explains discrepancy from petition
- Community reviews implementation
- Correction made if challenge valid
Section 10.2: Reversing Decisions
To reverse approved petition:
- Create new petition to reverse
- Requires same threshold as original
- Constitutional reversals need supermajority
- Bot implements reversal if approved
Section 10.3: Constitutional Violations
If petition violates constitution:
- Any member can raise challenge
- Special constitutional review petition
- Requires 2/3 vote to overturn
- Bot halts implementation pending review
Article 11: Petition History and Precedent
Section 11.1: Petition Archive
Bot maintains complete archive:
- All petitions (passed and failed)
- Discussion threads
- Vote tallies
- Implementation records
- Amendments and reversals
Section 11.2: Precedent Value
Past petitions inform future ones:
- Show community values and priorities
- Guide petition drafting
- Inform discussion
- Establish norms
- Not binding but instructive
Section 11.3: Periodic Review
Community can review past petitions:
- Identify policies needing update
- Consider consolidation
- Remove obsolete policies
- Via normal petition process
Article 12: Constitutional Amendments
Section 12.1: Amendment Process
To amend this constitution:
- Create constitutional petition
- Extended discussion period (7 days)
- Extended voting period (14 days)
- Requires 2/3 supermajority
- Bot updates constitution if approved
Section 12.2: Constitutional Interpretation
For interpretation questions:
- Member requests interpretation via petition
- Community discusses interpretation
- Vote on correct interpretation
- Guides future similar cases
- Bot applies interpretation
Section 12.3: Core Principles
Amendments should preserve:
- Direct democracy
- Member petition rights
- Transparent voting
- Equal participation
- Bot facilitation
Implementation Notes
This constitution creates direct participatory democracy:
- Accessibility: Any member can petition
- Transparency: All votes and outcomes public
- Simplicity: Straightforward petition and voting
- Flexibility: Multiple concurrent petitions
- Member Power: Direct decision-making authority
The bot should make petitioning easy, facilitate clear voting, implement decisions accurately, maintain complete records, and help members track governance activity.