{"kind":"vote","title":"Vote spec","version":"1.1","what":"The question, options, method, who may vote, window, quorum, threshold, tie and duplicate rules, delegation, and who runs it. VOTE.md is its text form.","status":"live","read_by":{"tool":"vote_spec","in_input":"(the whole input)","url":"https://www.voting.md/api/v1/vote_spec"},"filled_by":"The agent, from what the person asked for; the person approves it","plugs_in_later":"Agents posting open votes that other agents can join (planned, not live)","schema":{"type":"object","properties":{"question":{"type":"string","maxLength":200,"description":"The question, as it will be put to the voters."},"options":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":50,"description":"The options, 2 to 50 labels. Leave out for a yes/no question."},"yes_no":{"type":"boolean","description":"A yes/no question: options become yes, no (default when options are not sent)."},"method":{"type":"string","enum":["plurality","approval","ranked_choice","borda","condorcet","score"],"description":"How ballots are counted. One of plurality, approval, ranked_choice, borda, condorcet, score. Default plurality."},"eligible_voters":{"type":"array","items":{"type":"string"},"maxItems":200,"description":"Who may vote, as labels (agents or people)."},"eligible_count":{"type":"integer","minimum":1,"maximum":10000000,"description":"Or how many may vote, when the list is kept elsewhere."},"opens_at":{"type":"string","description":"When voting opens, ISO 8601 (default: now)."},"closes_at":{"type":"string","description":"When voting closes, ISO 8601. Or send window_hours."},"window_hours":{"type":"number","minimum":0.25,"maximum":720,"description":"How long the vote stays open from opens_at (default 24)."},"quorum_share":{"type":"number","minimum":0,"maximum":1,"description":"Share of eligible voters who must take part."},"threshold_share":{"type":"number","minimum":0,"maximum":1,"description":"Share the winner or yes must reach (0.5001 strict majority, 0.667 two thirds)."},"threshold_base":{"type":"string","enum":["cast","eligible"],"description":"cast (default) or eligible."},"tie_rule":{"type":"string","enum":["stop","runoff","status_quo"],"description":"stop (a person decides, default), runoff, or status_quo."},"duplicate_rule":{"type":"string","enum":["last","first","reject"],"description":"last (default), first or reject."},"delegation":{"type":"string","enum":["never","allowed"],"description":"Whether a voter may delegate their vote to another voter (default never)."},"max_delegation_depth":{"type":"integer","minimum":1,"maximum":10,"description":"Longest delegation chain honored (default 3)."},"initiated_by":{"type":"string","maxLength":60,"description":"The agent or person starting the vote, as a label."},"on_behalf_of":{"type":"string","maxLength":80,"description":"The person, team or body the vote is held for."},"invites":{"type":"array","items":{"type":"string"},"maxItems":200,"description":"Agents or people to invite, as labels (usually the eligible voters)."},"reminder_hours_before":{"type":"number","minimum":0,"maximum":168,"description":"Send a reminder this many hours before closing (0: none)."},"now":{"type":"string","description":"The current time, ISO 8601 (default: now)."}},"required":["question"]},"example":{"question":"Adopt the revised release plan for the next sprint?","yes_no":true,"eligible_voters":["agent-a","agent-b","agent-c","agent-d","agent-e","agent-f"],"window_hours":48,"quorum_share":0.5,"threshold_share":0.5001,"initiated_by":"planner-agent","on_behalf_of":"the release team","reminder_hours_before":6,"now":"2026-11-02T09:00Z"},"example_note":"Round illustrative numbers, not market data, a price or a quote; send your own.","disclaimer":"Use at your own risk. voting.md is provided as is, without warranty. Information here may be inaccurate, incomplete or not current, and is not verified; figures are estimates from the numbers you send and the formulas stated. Nothing here is legal, governance, election, corporate, financial, security or other advice, and no result here is a certified, official, binding or legally effective outcome. voting.md never runs, hosts, certifies or enforces an election, never verifies a voter, and never casts a vote a person didn't instruct. Check everything yourself before you act on it.","terms":"https://www.voting.md/terms"}