# The Kiduna Canon

**One document: everything that defines Kiduna · August 1, 2026 · standalone**

---

Kiduna is one application — the creation engine for the agentic internet, owned and operated by Kinship Duna, the genesis organization. A member is always **in** something (a Realm), always **doing** something (a Scene), on **some device** (a Surface), always able to talk to **Ki**, the one intelligence that runs through everything. Everything in the system is one of seven kinds of thing (the Elements), every container is one of ten kinds (the Realm types), every agent is built from six kinds of input (the Capacities), and everything is *about* something (the Themes). This is the whole canon; the rest is detail.

The name is **Kiduna** — one word for the system, the application, and the world. "Kidunaverse" is retired.

## The eight Scenes — what you're doing

A Scene is a unique place — a room, a scenario, an area — rendered in Flutter/Flame with its sprites, tiles, and interface elements: a cohesive set of Media connected to the full Kiduna stack. **Scenes connect through Portals** — a plain tap to enter; press-and-hold stays reserved for signatures. The eight canonical Scenes are the launch set; Builders create more.

**Discover — Atlas.** The navigable space of everything. Realms render as original icons, clustered by relation and Theme, arranged by **Gravity**: orbits of importance where distance means current relevance — never worth. What becomes relevant comes forward and grows; pan and zoom always override. Inspect anything; join what admits you. Read-only.

**Organize — Commons.** People: who to connect with, whose Wisdom to learn from, how collaboration forms. Relationships form here, sealed by a Handshake — a single-use word two people agree outside the system. Scoped to Realms: the containers people share, not a directory of everyone.

**Create — Studio.** Where Realms take their character: Wisdom (the knowledge), Presence (the system prompt), the name, the original SVG icons and interface elements, the Theme tags — what makes a veterans Realm feel different from a cricket Realm and a politics Realm. Allies are created and refined here the same way, and Scenes are built here too.

**Build — Workbench.** The maker's sandbox. Members implement their own **Abilities** — the same Capacity the platform ships — plus the agents, automations, and Scene code composed from them, and hand real coding work to Claude Code or Codex through the Workbench plugin. Safety is **Realm containment + the Builder role + inspection**: a custom Ability operates only in Realms where it is explicitly deployed, deployment requires the Builder role and is a named Action, anything can be inspected down to author and history, and Sentinels run an acceptance protocol (prompt injection, malicious code, bugs) before anything deploys. Trust the Realm you're in; trust the Ability deployed there.

**Govern — Forum.** Proposals, deliberation, votes, allocation. **Votes are equal-weight, never weighted by money or holdings** — every member the same, in every Realm. Passage executes deterministic Actions; every act leaves a Record whose plain sentence is generated from the executing command itself, so it cannot lie. Releasing a duna's own token is a later Forum capability.

**Settle — Exchange.** Deliberately simple: buy Compute with $KIDUNA; move between $KIDUNA and USDC, wallet to wallet. Three facts stay visible everywhere: units held, wallet value in dollars, the current price. One currency at launch; duna tokens join when ready.

**Enjoy — Garden.** Where built things get used — the Scene the whole system exists for. A veteran arrives as a veteran; someone takes a course, helps a candidate, runs a rideshare, guides tourism, navigates care, opens a store. Every app is a deployed Scene, entered through a Portal, rendered through the **composition grammar**: ~15 interface primitives (cards, panels, lists, maps, schedules, tiles, chips, action cards) with combination rules and a deterministic renderer. Launch apps are authored compositions; later, Ki composes generatively within the grammar — arranging primitives, never inventing them; Actions always render as deterministic chips and cards.

**Store — Vault.** The wallet-shaped Scene, web-only: on-ramp, off-ramp, storage. Fiat in, $KIDUNA out, balances and history plain, custody rights stated in plain language.

## The four Surfaces — where you are

A Surface is a form factor, not a product. Every Scene reaches every Surface except Vault (web-only). A basic version of all four ships in the initial release — depth varies, presence does not.

- **Desktop** — the working distance: the Field on the left, Ki on the right (~70/30). Density, inspection, governance, commitment. Designed for 1280px, functional to 1024.
- **Mobile** — the human distance: presence, capture, coordination, bounded decisions; Ki as a bottom sheet. iOS 16+ / Android 10+. Mobile can confirm most consequential Actions.
- **CTV** — the shared big screen: Flutter/Flame on Android TV, driven by the mobile devices in the room, several people at once. The Garden's communal form.
- **Extension** — the Chrome sidebar: the agentic internet alongside the ordinary one, everything filtered through Kinship Codes. Registered things light up with what they trace to; unregistered stays a stranger, not a threat.

**Allies are in every view.** The people render wherever you are — every Scene, every Surface — and selecting an Ally opens it: who it represents, its Presence, and how to engage. All surfaces are Flutter/Flame; the modes are Chat and Live; the accessibility baseline is WCAG 2.2 AA. There is no offline mode — not connected means not present; downloads are just downloads.

## The six Capacities — how an agent is built

1. **Inform with Wisdom** — the vector database: what it knows.
2. **Instruct for Presence** — the system prompt: how it carries itself.
3. **Empower with Connections** — integrations, third-party systems and software: what it can reach.
4. **Enable with Automations** — deep agents and triggers: what it keeps doing without being asked twice.
5. **Impart Abilities** — skills, markdown files: what it knows how to do.
6. **Align for Coherence** — Sentinels and values: what watches the work and keeps it true.

Every Ally, every Realm intelligence, every Actor is built from these six and nothing else.

## The seven canonical Elements — what things are

1. **Realms** — what can be entered.
2. **Actors** — all agents that are not Allies: Operators, Envoys, Sentinels, Workers, Supervisors, and kinds not yet named. An open-ended class.
3. **Media** — stable stored content: files, images, video, documents, structures. Some Media feeds the Wisdom stores; Scenes are compositions of Media.
4. **Allies** — the members' representatives: the visible identity of a person, with the human **Source** standing behind it in the data and governance model.
5. **Resources** — what things cost and how they're paid for: Compute, $KIDUNA, USDC, treasuries, capacity.
6. **Actions** — the deterministic, reserved operations intelligence is never allowed to improvise: moving money, issuing tokens, finalizing votes. Named, typed, executed only through the command boundary.
7. **Offers** — what is put forward for others to take up: goods and services, one-time or subscription.

## The ten Realm types

**Ecosystem · Organization · Alliance · Program · Project · Relationship · Community · Institution · Concept · Cell**

Every Realm nests inside Kinship Duna — the Ecosystem — and every Realm has full parity of capability: it can be shaped, connected, entered, and governed. A closed set; new types only by canon amendment.

## The Themes — what things are about

Not an eighth Element: a tagging layer in the Kinship Graph, applicable to Realms, Allies, and Offers — at most three per Realm. Elements say what a thing *is*; Capacities what it *can do*; Themes what it's *about*. Themes aggregate up the Realm nesting ("show me everything happening in Health"), power Gravity and discovery, and let the Graph route introductions by affinity. Open sub-themes live beneath the fixed spine and join it when the Ecosystem adopts them. Twenty-six themes, six clusters:

**People & Care** — 1. Health & Wellbeing (fitness, nutrition, disability, caregiving) · 2. Mental Health & Recovery (therapy, addiction recovery, grief) · 3. Relationships & Family (partnership, parenting, elders, friendship) · 4. Service Communities (veterans, military families, first responders)

**Society & Justice** — 5. Justice & Solidarity (human rights, solidarity movements, refugees, economic justice) · 6. Civic Life & Governance (democracy, elections, policy, public institutions) · 7. Community & Mutual Aid (neighborhoods, volunteering, mutual-aid networks) · 8. Safety & Resilience (disaster relief, preparedness, public safety)

**Culture & Play** — 9. Arts & Culture (music, film, visual art, performance, literature) · 10. Heritage & Identity (diaspora, language, indigenous communities, LGBTQ+) · 11. Spirit & Meaning (faith, spirituality, philosophy, mindfulness) · 12. Sports & Recreation (leagues, outdoors, adventure) · 13. Games & Entertainment (gaming, fandom, nightlife, live events) · 14. Storytelling & Journalism (local news, podcasts, publishing)

**Place & Planet** — 15. Travel & Tourism (hospitality, destinations, guides) · 16. Environment & Climate (conservation, sustainability, wildlife) · 17. Energy & Infrastructure (solar, grid, water, broadband, transit) · 18. Housing & Place (housing access, placemaking, homelessness) · 19. Food & Agriculture (restaurants, farming, food systems) · 20. Animals (pets, animal welfare, rescue)

**Work & Wealth** — 21. Work & Trades (labor, careers, crafts, co-ops) · 22. Business & Markets (small business, startups, retail, professional services) · 23. Money & Finance (personal finance, community finance, investing)

**Knowledge & Frontier** — 24. Education & Learning (K-12, higher ed, skills, tutoring) · 25. Science & Research · 26. Technology & Digital Life (software, AI, privacy, digital rights)

Cluster names are internal — they organize the icon system; members see the plain theme names.

## The rules that bind everything

**Ki.** One intelligence behind everything; context follows location; speaks in the third person; proactive by default; never a character in the Field. Everything you can do by touching, you can do by saying.

**Identity is person-vouched.** A Kinship Code from a current member plus a Handshake agreed out-of-band. No email, no phone, no third party — the inviter is the verification. Invite-only at launch; joining is one hundred dollars, once, for life — the initial Compute purchase.

**The economy is on the blockchain, and the intelligence runs it.** Every member has a FROST wallet; every Organization, Alliance, and Institution has a Squads wallet; Communities and Relationships hold none. Everything moves wallet to wallet — $KIDUNA and USDC — orchestrated by agentic AI, with no external token platform and no new smart contracts at launch: the orchestration and database layers do that work over the real wallets. Liquidity never fragments — all $KIDUNA at launch. The **Agency Premium** is the engine: each organization sets what its intelligence costs; part of the premium flows to its treasury; the waterfall distributes the rest.

**The command boundary.** The graph service is the sole policy and command boundary: intelligence proposes, deterministic code authorizes and commits. Named commands; receipts generated from the executing parameters, so they cannot lie; simulations structurally unable to touch real rails.

**The privacy hierarchy.** An item may carry more privacy than its context, never less. Public is only really public in a public Realm; the Realm sets the floor, members raise it item by item; an absence of information is a boundary, not a failure.

**The adoption rule.** Any Realm can adopt anything public or offered to it — the Realm decides. When the Ecosystem adopts something through regular governance, it's available everywhere. One rule for Abilities, Scenes, sub-themes, and whatever comes.

**The design repository.** All icons, symbols, and graphics across the eight Scenes — one consistent, growing library of original artwork that populates the universe.

**AI-native, and done means done.** No fixed menus, no procedural navigation — the member acts in the Field and talks to Ki, and the system composes what's needed. And the release standard is complete, not minimum: eight Scenes, four Surfaces, real apps in the Garden, the whole member journey working — invitation, Handshake, one hundred dollars, wallet, Ally, Realm, Relationship, proposal, vote, purchase, app — every consequential step behind the command boundary, every movement leaving a Record.

**Everybody eats.**
