Playbook blueprints
One visual blueprint per playbook: who uses it, the numbered flow from trigger to closed evidence, the guard rails that bound it, and a worked example. Optimizers propose; claim gates authorize; playbooks never settle or pay.
Reflex rules (21)
Building reflex — the building reacts to its own state
softReflexWhen a space entity state changes (building, drain, road segment), the reflex evaluates registered rules and actuates the next step — paging the right desk, opening a case, or dispatching a crew. The platform's spinal-cord reflex for physical assets.
Community sourcing — find the right hands for the job
softReflexTurns a staffing requirement (crew, inspector, technician) into offers from qualified providers, shortlists them, and binds one — so the city never assigns work by guesswork. It is the sourcing bus other playbooks wire into.
sourcingsolve
Geofence / SCE — the city notices crossings
softReflexReacts to proximity events — a vehicle, crew, or sensor crossing a registered boundary of a road/drain/asset — by evaluating the crossing against rules and notifying or opening a case.
Mars ICE dispatch (SOS) — emergency response, governed
liveReflexThe emergency (SOS) signal for multi-agency response — water, power, road, hospital, flood. Converts a distress signal into a governed dispatch with proof of correct execution, so a response is never claimed without evidence.
Waste collection — garbage management with recourse
softReflexHousehold accumulation signals become replanned collection routes; completion is a record, not a device ping; a missed collection is rescheduled, never silently dropped.
sourcingsolveoptimize
Weather preparation — prep is reversible, dispatch is not
softReflexThe rain/flood preparation ladder — rain-gauge triggers a pre-alert, sandbags and crews pre-position, then a post-event report closes the loop. Reversible prep happens automatically; consequential dispatch needs a human.
sourcingsolveoptimize
Help-desk auto-route — every report gets a desk, fast
softReflexCommunity ticket intake (free text, WhatsApp, USSD) is classified and assigned to the right desk category (maintenance, security, pest, cleanliness, other), graded within SLA by a human, and closed only with evidence.
Complaints ladder — escalation by the clock
softReflexEvery complaint has an explicit escalation path — acknowledge by class, then urge, then escalate, then ward office — driven by SLA clocks, not by who knows whom.
Route watch — patterns, not fines
softReflexThree or more similar unresolved complaints in the same block within a declared window open a pattern case — the systemic signal that a street, drain, or fixture is failing repeatedly. It routes like any other case; it never fines anyone automatically.
Patch rounds — preventive maintenance by the clock
softReflexRecurring preventive ticks for streetlights, manholes, and public furniture — each due occurrence emits an expected-visit plus a record step via the sourcing bus to a solver route verdict. A missed round re-schedules by the same guard.
solve
Payments meters (dues ladder) — arrears handled politely
softReflexPublic dues/fees follow a polite ladder — reminder, notice, grace, escalate — with lifeline-degrade rules as values. Arrears degrade politely and never hard-block life-safety services.
School zones — safer roads around schools
softReflexTime-windowed movement governance around schools: calendar windows restrict through-traffic to safer flow near school gates, crossing guards are rostered, and parent/caretaker advisories subscribe to the safety state.
Traffic incidents — patterns before penalties
softReflexRoad-incident / accident pattern detection: three or more reports on the same corridor open a pattern case; jam-measure triggers and traffic-light flow playbooks respond to quantified signals.
Civic reporting boards — publish the work, with approval
softReflexAggregates closed civic work (faults fixed, rounds completed, dues collected) into monthly board digests per ward. The AI drafts; a human approves; only then does it publish. There is no auto-publish anywhere.
Mall tenancy — multi-tenant facility operations
softReflexStall, board, and occupancy tracking on existing storefront entities; a security incident ladder from ward security to the emergency desk; booking / deck reservations for weekly community use; revenue hooks into metering.
Public-space rounds — parks and playgrounds on a schedule
softReflexPublic furniture, park, and playground maintenance rounds wired to the same rounds tick as patch rounds: each due occurrence emits an expected-visit and a record step via the sourcing bus to a solver route verdict; a missed round re-schedules.
solve
Resident options (dweller upsells) — offer, never force
softReflexOptional services for residents (blocks/units registered with no personal data): the playbook surfaces relevant add-ons and the resident chooses. No forced enrolment, no auto-charge.
Relief cases (emergency housing) — under the SOS ceiling
softReflexEvacuation placements and short-term subsistence evidence after a disaster or eviction. Relief is a child of SOS: it inherits the parent ceiling and may only tighten it — never widen scope.
Social housing queue — allocation by declared bands
softReflexHousing allocation queues: application → needs scoring by declared bands → ranked queue → offers. Eligibility resolves by key from governed lookups with values only; individual enumeration is forbidden.
Rent / lease register — occupancy with a memory
softReflexLease registration / renewal events maintain the occupancy register; use-change events append use-change history per parcel (the entity's recorded life).
Valuation disclosure — comparables with provenance
softReflexMarket valuation comparison: similar parcels' evidence becomes transparency findings. Evidence-based only; no automated gouge projection; every finding carries its provenance. Comp prices are UNKNOWN until sourced.
Scenario packs (7)
Civic maintenance tick — the recurring civic round
softScenarioRecurring civic checklist rounds in standing-order style: fault reported → fair sourcing of a crew → scheduling / routing → photo-or-arrival-point proof → verified disbursement. The everyday engine of ward maintenance.
sourcingsolveoptimize
Civic inspection cycle — inspect, score, remedy
softScenarioPublic facility inspection as a staged case: open → inspect (photo + GPS stamped) → score against the open checklist rubric (values) → remedy ladder (minor fix / re-inspect / escalate) → close with a PoCE seal.
Public reporting digest — the publication desk
softScenarioWeekly / monthly digests of closed work per ward rendered from the canonical story into EN / SW / FR value packs. Advisory draft → approved; never auto-publish. It consumes closed-work telemetry, so upstream verdicts are rendered as gates, not recalculated.
Zoning permit — permission with due process
softScenarioPermit application → zoning check (values only) → quorum decision → deed record on the land-parcel entity. Unknown or ambiguous parcels refuse; open conflict tickets pause the flow.
Encroachment notice — evidence first, notice second
softScenarioSuspected structures on land: evidence attached → neighbor + owner notified (due process) → review (quorum if disputed) → resolution / receipt. Child states inherit parent limits and never widen them.
Building compliance inspection (property) — certify only with an expert
softScenarioBuilding hygiene / fire / accessibility inspections ending in certificate issuance — but only with expert sign-off. Export a compliance packet. No auto-certification, no auto-fine.
Building safety inspections (facilities) — large buildings, full packet
softScenarioThe facilities-flavored sibling: large-building compliance inspections (fire, accessibility, hygiene) ending in expert sign-off, certificate issuance, and a compliance-packet export for big managed buildings.
Starter packs (7)
Ontology pack — the shared list of names
softStarterEstablishes the shared entity spine every other playbook depends on: land / parcel / space hierarchy, entity identities, and lifecycles. No pack works until the names agree.
Maintenance desk pack — report → dispatch → verified
softStarterThe JMII-style maintenance entry: WhatsApp / USSD intake, classify, nearest certified vendor proposal, one-tap approval, photo + GPS verification, PoCE receipt, escrow-until-proof.
sourcingsolve
Financial desk pack — dues, fines and payables, accounted
softStarterFIN-native ledger per community: accounts, AR / AP, period close; dues, fines, service charges, vendor payables; scheduled reminders; monthly statement + dashboard.
Community desk pack — announcements, gates, visits
softStarterCommunity desks: announcements, gate passes, visitor logs, polling — the daily social fabric of an estate or ward.
Emergency guard pack — the safety pairing
softStarterThe community guard pairing inside the safety stack: guard roster, incident reporting, and escalation into the emergency desk.
Civic maintenance full pack — the complete round
softStarterThe full lifecycle expansion of the civic maintenance tick: report → dispatch → verified disbursement, end to end, as one bundle.
sourcingsolveoptimize
Zoning parcel ops pack — the parcel's daily operations
softStarterParcel-centric operations: registrations, use changes, valuations, and permits bound to the parcel entity — the working surface for the property-compliance family.