Rationale AI

​

Request Headers

​

Request Body

​

Custom System Prompts

​

Default System Prompt

You are an expert analyst tasked with producing a comprehensive, structured, and easy-to-understand analysis of a community vote or live proposal. Your job is to break down vote data clearly and interpret voter rationales with depth and nuance. You must return all data in Markdown format for readability.

Your response must be well-structured using bullet points, numbered lists, and clear headings. Combine structured formatting with insightful analysis while maintaining conversational, accessible language.

​

Using Custom System Prompts

{
  "govaction_id": "gov_action123...",
  "vote_type": "no", 
  "for": "drep",
  "custom_system_prompt": "You are a political scientist specializing in decentralized governance. Focus on institutional dynamics, power structures, and democratic theory. Analyze voting patterns through the lens of public choice theory and collective action problems. Provide academic-level insights with citations to relevant literature where applicable."
}

​

Best Practices for Custom Prompts

​

Custom Prompt Examples

You are a political scientist specializing in digital democracy and decentralized governance systems. Analyze the voting rationales through the lens of democratic theory, focusing on:

1. Representation quality and delegate responsiveness
2. Information asymmetries and voter competence
3. Coalition formation and factional dynamics
4. Institutional design effects on outcomes

Structure your analysis as an academic paper section with clear theoretical frameworks. Reference relevant concepts from political science literature such as principal-agent theory, median voter theorem, or collective action problems where applicable.

You are a blockchain treasury analyst with expertise in decentralized finance and risk management. Evaluate the voting rationales from a financial perspective, focusing on:

1. Fiscal responsibility and sustainability concerns
2. Risk assessment and mitigation strategies
3. Economic incentives and market dynamics
4. Treasury management best practices

Provide quantitative insights where possible and structure your analysis as a risk assessment report with clear recommendations for financial governance.

You are a legal expert specializing in blockchain governance and constitutional law. Analyze the voting rationales for legal and constitutional compliance issues, focusing on:

1. Constitutional adherence and procedural compliance
2. Legal precedent and governance framework integrity
3. Rights protection and due process concerns
4. Regulatory implications and compliance risks

Structure your analysis as a legal memorandum with clear constitutional interpretation and compliance recommendations.

You are a blockchain developer and systems architect with expertise in governance implementation. Evaluate the voting rationales from a technical feasibility perspective, focusing on:

1. Implementation complexity and technical risks
2. System architecture and scalability concerns
3. Integration challenges and compatibility issues
4. Performance impact and resource requirements

Provide technical depth appropriate for development teams and structure your analysis with clear implementation recommendations.

​

Tips for Better Analysis

​

Custom Prompt Guidelines

• Specify your expertise area and perspective
• Define the analysis framework or methodology
• Set clear expectations for output format
• Include specific focus areas or evaluation criteria
• Use domain-specific terminology appropriately

• Override essential vote data (automatically preserved)
• Request formats incompatible with the governance context
• Use prompts that ignore the provided rationales
• Create prompts that don’t match your stakeholder group filter
• Make the prompt overly complex or contradictory

​

Response Structure

{
  "data": {
    "analysis": {
      "DRep": "## 📊 What the Numbers Tell Us\n\n- **Explicit No Votes**: 1.62B ADA (active voters who chose \"No\")\n- **Not Voted**: 1.55B ADA (eligible voters who didn't participate)\n...",
      "SPO": "## 📊 What the Numbers Tell Us\n\n- **Explicit No Votes**: 612.37M ADA (active voters who chose \"No\")\n- **Not Voted**: 13.89B ADA (eligible voters who didn't participate)...",
      "ConstitutionalCommittee": "## 📊 What the Numbers Tell Us\n- **Explicit No Votes**: N/A ADA (active voters who chose \"No\")\n- **Not Voted**: N/A ADA (eligible voters who didn't p..."
    },
    "proposal_id": "gov_action10ueqgzwenxr39le68n0se9peu92r7gm2846xwehh3u0ahc0qd0uqqyljxu5",
    "proposal_title": "Set 2025 Net Change Limit of 300M ADA, 2026 Net Change Limit of 250M ADA",
    "vote_type": "no",
    "vote_percentages": {
      "SPO": {
        "counts": { "No": 22, "Yes": 29, "Abstain": 1 },
        "majority": "No",
        "percentages": { "No": 96.44, "Yes": 3.56 }
      },
      "DRep": {
        "counts": { "No": 111, "Yes": 141, "Abstain": 15 },
        "majority": "No",
        "percentages": { "No": 65.25, "Yes": 34.75 }
      },
      "ConstitutionalCommittee": {
        "counts": { "No": 4, "Yes": 1, "Abstain": 1 },
        "majority": "No",
        "percentages": { "No": 83.33, "Yes": 16.67 }
      }
    }
  },
  "meta": {
    "group_filter": "all",
    "vote_type": "no",
    "rationale_counts": {
      "DRep": 26,
      "SPO": 1,
      "ConstitutionalCommittee": 4
    },
    "total_rationales_processed": 31,
    "precise_token_count": 6276,
    "token_limits": {
      "gpt4o_max_context": 18000,
      "safe_input_limit": 7600,
      "output_token_reserve": 5000
    },
    "processed_votes_count": 137,
    "processing_method": "precise_token_based_summarization",
    "custom_prompt_used": false,
    "timings": {
      "fetch_proposal_data": 247,
      "fetch_votes": 132,
      "extract_rationales": 12,
      "generate_ai_analysis": 38004,
      "total": 38396
    }
  },
  "rationales": {
    "DRep": [
      {
        "id": "drep1y23kabcdefg...",
        "comment": "I'm voting \"No\" on t..."
      }
    ],
    "SPO": [
      {
        "id": "pool1vc8jhijklmn...",
        "comment": "Please provide some ..."
      }
    ],
    "ConstitutionalCommittee": [
      {
        "id": "cc_hot1qvr7p6mlmnopqus...",
        "comment": "The published rationale for t..."
      }
    ]
  }
}

​

Response Filtering Logic

​

Analysis Output Format

• 📊 What the Numbers Tell Us: Vote breakdown and community sentiment
• 🎯 Main Concerns and Themes: Top 3-4 identified themes with explanations
• 💡 What Matters Most to These Voters: Core values and principles
• 🤔 Mixed Feelings or Conditions: Conditional statements and uncertainties
• 👥 How Their Role Influenced Their Thinking: Role-specific perspectives
• 🎯 Bottom Line: Summary of main reasoning

​

Processing Methods

• Direct Analysis (≤7,600 tokens): Single comprehensive analysis
• Token-Based Summarization (>7,600 tokens): Intelligent chunking with summary synthesis

​

Technical Specifications

• Context Window: GPT-4o 18,000 tokens
• Safe Input Limit: 7,600 tokens (70% of capacity)
• Token Measurement: Precise GPT tokenizer counting
• Processing: ALL available rationales (complete coverage)

​

Status Codes

​

Notes

​

Advanced Usage Tips

​

Multi-Perspective Analysis Strategy

• Run the same query with different custom prompts
• Compare results across stakeholder groups
• Analyze both Yes and No votes for complete picture
• Use different analytical frameworks for deeper insights

1. Start with default analysis for comprehensive overview
2. Apply domain-specific prompts for targeted insights
3. Use legal/compliance perspective for risk assessment
4. Apply technical lens for implementation considerations

​

Prompt Optimization Tips

• Start with broad expertise-based prompts
• Refine based on initial results
• Add specific focus areas as needed
• Test different analytical frameworks

• Reference your organizational context
• Include relevant regulatory requirements
• Consider stakeholder communication needs
• Align with existing analytical processes

• Compare custom prompt results with default analysis
• Validate insights against known stakeholder positions
• Cross-reference with other governance data sources
• Consider multiple analytical perspectives for important decisions