Pod Management Guide
What are Pods?
Pods are working groups or teams within Spirit DAO. Each pod has:
- Unique purpose: Specific mission or focus area
- Members: Contributors with membership Hat tokens
- Leaders: Manage pod and approve members
- Modules: Optional features (Forum, Events, Bounties, Treasury, and more)
- Permissions: Control who can access what
Pods can be time-restricted or eternal: some are created for a fixed span, and others run indefinitely.
Pod Roles
Executive Pod Member
- Can create new pods
- Highest level of DAO access
- Manages DAO-wide settings
- Approves other pods
Pod Leader
- Manages their specific pod
- Approves/rejects member applications
- Can remove members
- Deploys pod modules
- Signs agreements on behalf of pod
Pod Member
- Participates in pod activities
- Can post in pod forum
- Can register for pod events
- Can apply for pod bounties
- Must follow pod agreements
Finding & Joining Pods
Browse Pods
- Go to Pods page
- View all active pods
- See pod details:
- Name and description
- Member count
- Active modules
- Application status
View Pod Details
- Click on any pod card
- See full information:
- Description and mission
- Current members with profiles
- Leadership structure
- Active modules (Forum, Events, Bounties)
- Membership requirements
Apply for Membership
- On pod details page, click "Apply for Membership"
- Review membership agreement (if exists)
- Fill out application form:
- Why you want to join
- Relevant skills/experience
- Expected contribution
- Sign agreement (blockchain transaction)
- Submit application
- Wait for leader approval
Application Status:
- Pending: Submitted, awaiting review
- Approved: Accepted, Hat token will be created
- Rejected: Not accepted, can reapply
After Approval
- Leader approves your application
- Your membership Hat is automatically created
- You receive notification
- Hat appears in your identity
- You can now access pod features
Creating a Pod
Required: Must be Executive Pod member
Step 1: Navigate to Create Pod
- Go to Pods page
- Click "Create Pod" button (only visible if you have permission)
- Choose creation method:
- Create with Modules (Recommended): Full featured pod
- Simple Creation: Basic pod without modules
Step 2: Fill Basic Information
Pod Name:
- Clear, descriptive name
- Will appear in all pod listings
Description:
- Explain pod's mission and purpose
- What the pod does
- Who should join
Image:
- Upload pod logo or image
- Represents pod visually
- Optional but recommended
Parent Pod:
- Select parent pod (usually "Executive Pod")
- Creates hierarchical structure
- Inherits some permissions
Step 3: Add Pod Leaders
Minimum: 2 leaders required (for accountability)
- Search for members by name or address
- Click to add as leader
- Each leader must sign accountability agreement
- Agreement includes:
- Acting with integrity
- Personal liability
- Compliance with rules
- No misappropriation of funds
Important: Leaders have significant power and responsibility
Step 4: Set Eligibility Criteria (Optional)
Control who can join:
Token Balance:
- Require specific token
- Minimum balance amount
- Example: "Must hold 5 USDC"
NFT Ownership:
- Require specific NFT
- Example: "Must hold Advocate"
Other Pod Membership:
- Must be member of another pod first
- Example: "Must be in Contributor Pod"
Step 5: Enable Modules (Optional)
Available Modules:
Pod modules come in three kinds:
- Core (included): Chat, Forum, Treasury, Governance, Events, Bounties, Marketplace, Knowledge Base, Sub-Pods
- Add-ons: Surveys, Password Vault
- Paid: Community AI Agent (a monthly $SYSTEM subscription)
Forum Module:
- Pod-specific discussion board
- Create threads and posts
- Pod members only
Events Module:
- Pod-specific events
- Event registration
- Attendance tracking
Bounty Module:
- Pod-specific task marketplace
- Funded from pod treasury
- Restricted to pod members
Treasury Module:
- Multi-sig treasury
- Hold pod funds
- Transparent accounting
Step 6: Review and Create
- Review all information
- Confirm accountability agreement
- Click "Create Pod"
- Sign blockchain transaction
- Wait for confirmation
- Pod appears in listings
Note: Pod creation may take 30-60 seconds to sync
Managing Your Pod
Access Pod Management
- Go to Pods page
- Click on your pod
- Click "Manage Pod" button (only visible to leaders)
Pod Management Dashboard
Members Tab
View All Members:
- See list of current members
- View member profiles
- See member roles (Leader vs Member)
Add Member Manually:
- Click "Add Member"
- Search by name or address
- Select member
- Choose role (Member or Leader)
- Member receives notification
- Hat is automatically created
Remove Member:
- Click "Remove" next to member name
- Confirm removal
- Member's Hat is deactivated
- Member loses pod access
- Removal is immediate
Important: Removed members can reapply
Applications Tab
Review Pending Applications:
- See all pending applications
- Click on application to view details
- Read applicant's responses
- View applicant's profile
Approve Application:
- Click "Approve"
- Confirm decision
- System automatically creates Hat token
- Applicant receives notification
- Applicant can now access pod
Reject Application:
- Click "Reject"
- Optionally add reason
- Applicant receives notification
- Application moves to rejected status
Vote on Application (if configured):
- Click "Vote"
- Select Approve/Reject
- All leaders must vote
- Requires majority approval
- Automatic execution after voting ends
Modules Tab
View Active Modules:
- See which modules are enabled
- Check module status
- View module settings
Deploy New Module:
- Click "Deploy Module"
- Select module type (Forum, Events, Bounties, Treasury)
- Configure module settings
- Sign transaction
- Wait for deployment (30-60 seconds)
Module Configuration:
- Each module has specific settings
- Can toggle public vs. pod-only access
- Can set permissions per module
Treasury Tab (if enabled)
View Treasury Balance:
- See all token balances
- View transaction history
- Check multi-sig settings
Multisig Transactions:
- Requires multiple leader signatures
- Prevents single point of failure
- Transparent and on-chain
Fund Treasury:
- Click "Fund Treasury"
- Select token and amount
- Approve transaction
- Funds appear in treasury balance
Settings Tab
Edit Pod Information:
- Update description
- Change image
- Modify settings
Manage Agreements:
- View signed agreements
- Update membership agreement
- Add new agreements
Danger Zone:
- Delete pod (requires all leader approval)
- Transfer leadership
- Disable pod
Pod Agreements
What are Agreements?
- Legal-style documents members must sign
- Stored on IPFS (permanent, decentralized)
- Signed on blockchain
- Enforces expectations and rules
Types of Agreements
Membership Agreement:
- Required to join pod
- Outlines member responsibilities
- Defines acceptable behavior
- Signed during application
Accountability Agreement:
- Required for leaders
- Personal liability clause
- Anti-fraud provisions
- Signed during pod creation
Custom Agreements:
- Pod-specific rules
- Special requirements
- Additional terms
Creating Agreement
- Write agreement text (Markdown supported)
- Upload to IPFS
- Link to pod
- Mark as required or optional
- Members must sign before access
Viewing Signed Agreements
- Go to pod management
- Click "Agreements" tab
- See list of agreements
- View signatures and timestamps
- Download agreement text
Pod Permissions
Permission Types
View Pod:
- Public: Anyone can see
- Members Only: Must be member
Post in Forum:
- Leaders Only
- All Members
- Public
Create Events:
- Leaders Only
- All Members
Post Bounties:
- Leaders Only
- Treasury Multi-sig
Access Treasury:
- Leaders Only (multi-sig)
Managing Permissions
- Go to pod management > Settings
- Click "Permissions"
- Select permission level for each feature
- Save changes
- Changes apply immediately
Pod Modules in Detail
Forum Module
Enables:
- Pod-specific discussion board
- Thread creation
- Post replies
- Markdown formatting
Access:
- Pod members only (unless set to public)
- Leaders can moderate
- Delete inappropriate posts
Events Module
Enables:
- Pod-specific events
- Event creation
- Registration system
- Attendance NFTs
- Check-in functionality
Use Cases:
- Team meetings
- Workshops
- Social gatherings
- Milestone celebrations
Bounty Module
Enables:
- Task marketplace
- Bounty creation
- Application system
- Work submission
- Payment processing
Funded By:
- Pod treasury
- Requires treasury module
- Multi-sig approval for large bounties
Treasury Module
Enables:
- Multi-sig wallet
- Hold tokens (USDC, ETH, etc.)
- Fund bounties
- Pay contributors
- Transparent accounting
Security:
- Requires multiple leader signatures
- On-chain and auditable
- Protected from single actor
Best Practices
As a Leader
Application Review:
- Review applications within 48 hours
- Provide feedback if rejecting
- Look for alignment with pod mission
- Check applicant's identity profile
Member Management:
- Communicate regularly
- Recognize contributions
- Address issues promptly
- Be fair and consistent
Module Deployment:
- Only deploy modules you'll use
- Configure permissions carefully
- Test modules after deployment
- Train members on features
Treasury Management:
- Keep balances reasonable
- Use multi-sig for all transactions
- Document all expenditures
- Report to members regularly
As a Member
Active Participation:
- Engage in forum discussions
- Attend pod events
- Complete bounties you take on
- Help new members
Follow Rules:
- Honor signed agreements
- Respect pod leaders
- Be professional
- Report issues to leaders
Contribute Value:
- Share expertise
- Propose improvements
- Take on bounties
- Support pod mission
Troubleshooting
"Can't Create Pod" Error
- Check role: Must be Executive Pod member
- Check wallet: Must be connected
- Check network: Must be on Base
- Try refresh: Sometimes state gets outdated
"Application Not Showing"
- Wait for sync: Can take 30 seconds
- Check filter: Remove any active filters
- Refresh page: Force reload
- Check notifications: May have been approved/rejected
"Can't See Module"
- Check module status: May not be deployed yet
- Check permissions: May not have access
- Wait for sync: Module deployment takes time
- Ask leader: May need manual access grant
"Hat Not Received"
- Wait 60 seconds: Blockchain sync time
- Refresh identity page: Check identity page
- Check transaction: View on block explorer
- Contact leader: May need manual grant
Advanced Features
Pod Hierarchy
- Pods can be nested under parent pods
- Inherits some parent permissions
- Creates organizational structure
- Useful for large DAOs
Time-Based Memberships
- Set expiration dates on Hats
- Members auto-removed after period
- Useful for seasonal roles
- Can be renewed
Eligibility Criteria Stacking
- Combine multiple requirements
- Example: "Need NFT AND token balance"
- Creates exclusivity
- Protects pod quality
Cross-Pod Permissions
- Members of one pod get access to another
- Creates collaboration paths
- Simplifies permission management
- Encourages pod interaction
Pod Lifecycle
1. Creation:
- Leader creates pod with mission
- Sets up initial structure
- Deploys needed modules
2. Growth:
- Accept applications
- Add members
- Expand modules
- Fund treasury
3. Activity:
- Regular forum discussions
- Events and meetings
- Bounty completion
- Value creation
4. Evolution:
- Update mission as needed
- Adapt structure
- Add/remove modules
- Leadership transitions
5. Closure (if needed):
- Complete outstanding bounties
- Distribute remaining treasury
- Archive content
- Formal sunset
Master pod management to build thriving communities! 🌱