Skip to main content

Areas

What an area is

A named subdivision of a community that holds a set of decisions. Nothing more complicated than that — and its simplicity is the point.

communities/<community>/areas/<area>/
area.yaml
decisions/
decision_1.yaml decision_1.md
decision_2.yaml decision_2.md

Why the middle layer exists

Because a community is too coarse to aggregate over and a decision is too fine.

Two citizens in the same community may be working on entirely unrelated questions; pooling across all of it would produce an average of nothing. Two citizens working in the same area are looking at the same body of material — so their disagreement is meaningful, and so is their agreement.

Aggregation therefore happens at the area.

The cursor

Which community you are currently in is a cursor — per-user state, rendered as a dropdown at the top of the areas list.

It is deliberately not a navigation event and deliberately not part of the left bar. Switching communities should cost one click and no reorientation; making it a route would turn a lightweight context change into what feels like leaving the application.

Numbering

Decisions are numbered within their area. The number is stable — decision 4 stays decision 4 even if decision 3 is withdrawn — because a citation into an area's decision has to keep resolving.

Scope, and the layered libraries

The area is also a layer in the context assembly. When a decision is calculated, the engine walks:

Earth -> country -> state/province -> community -> AREA -> decision

An area can carry its own facts and its own metaphysics, applying to everything inside it and nothing outside. That is how a working group can establish shared background once instead of restating it in every chain.

Keys

Lowercase, underscored slugs, frozen at creation. Same rule as everywhere else in the product, for the same reason: identity must survive renaming.