Skip to main content

Decisions, Areas And Communities

Most civic software asks for your opinion and hands you a number back. This hands you a workspace. You take one question at a time, write down where you stand and why, list the evidence you hold and name the pieces you do not, and the software tells you whether that adds up to a conclusion. Communities and areas are the shelves those questions sit on.

A community holds areas, an area holds decisions, and inside one decision the links you have are weighed against the gaps you have explained, producing either a conclusion at the threshold you set or an honest refusal to conclude.

What it does

The hierarchy is three tiers. A community is a named workspace stored as a directory on disk. An area is a named topic inside it. A decision is one resolved question inside that topic.

A community carries an explicit access list: owners, writers, readers. Owners change the list and can delete the workspace, writers create and edit content, readers look. New communities are private. World-readability, which reaches a visitor who never signed in, is a flag an owner turns on deliberately. At least one owner must always remain, and all of it is enforced on the server. An area has no access list of its own; it inherits its community's.

The decision is the atom. Each one is stored twice: a structured record the software reads, and a human-readable companion regenerated from it on every save, so the readable version can never quietly disagree with the record the software computed from. Decision numbers are never reused, even after a delete, so a link to decision 4 in an area means the same thing forever.

A decision carries four things:

  • The question, and what kind of answer it takes — true or false, support or oppose.
  • Your position — where you stand, how sure you are, and a rationale in your own words.
  • The chain of evidence. Every link is either something you have, with a source and a strength from 0 to 1, or something you are missing. A missing link is not allowed to be vague: it must carry a reason from a closed list of four — classified, suppressed, blocked, or unknown.
  • Your act-anyway threshold — the confidence you personally require before you would act on this question. It is set per decision, because some questions deserve more certainty than others.

The software weighs what you hold against the gaps you explained and returns one of two answers. Either the conclusion is reached at the threshold you declared, published with the still-open gaps beside it, or it comes back "unsupported on the current record." There is no third branch where a missing link is quietly rounded away into a certainty nobody has.

None of this needs an account. On your own machine, signed in to nothing, you create areas, build chains and run the reasoning. The one act that asks who you are is publishing into a shared record.

The goal it serves

There is a trap that works every time it is tried. A slice of the record is classified, and anyone trying to recover that slice is blocked. The citizen holding almost the whole chain is then told no conclusion may be drawn without the last piece. The act of hiding the evidence becomes the thing that disqualifies the person who noticed.

This feature is the way out, and it is deliberately unglamorous: name the shape of the hole. A gap that is written down — what is missing, why, and under whose authority it is being withheld — stops being a silence you can be shamed with and becomes a fact sitting on the record beside everything else. Evidence makes that argument in full, and naming the gaps is the discipline behind it. A decision written this way is portable: someone who disagrees can point at the link they think is weak, or at your threshold, instead of at your character. Decisions walks through recording one.

Communities are the second half. Working alone is the default and complete on its own, but a question that matters usually has more than one person on it. A named owner, an explicit writer list and a private-by-default setting let a group build together without becoming a channel anyone can flood. Communities covers joining or starting one.

What keeps it honest

  • The gap vocabulary is closed. A missing link takes one of four reasons and nothing else. You cannot record a gap as a shrug.
  • The software is allowed to say no. "Unsupported on the current record" is a real and frequent outcome.
  • Your threshold travels with your conclusion. Anyone who thinks 85% is too low a bar can argue with the bar rather than with you.
  • The readable file is generated, never authored. Hand-edited prose is overwritten by the next structured save. There is one source of truth.
  • Access is re-checked on the server on every write, so the interface and the system cannot drift apart.

What it deliberately does not do: decide the question for you, compare citizens against each other, or publish a claim about any person. A decision is your own record on your own disk until you decide otherwise.

Works with

  • The AI Assistant — re-tests whether a conclusion follows from the links you hold, rather than from whether an authority agrees.
  • Value Systems And Policy Packets — supplies the written rules a decision is judged against, so the same standard applies to every question.
  • Say What We Could See — the same refusal to let a blank pass unexplained, applied to every published calculation.
  • Groups And Values Blocks — where individual positions become a stance a named body of citizens declares.

Where to go next

  • Decisions — recording a position and running the comparison.
  • Naming the gaps — why a withheld link is recorded as a finding instead of a reason to stay quiet.
  • Communities — what a community is, and how to join or start one.
  • The core loop — where this workspace sits in the sequence.
  • Run it on your computer — install it and open a decision of your own, no account required.