ICN Institutional Operability Roadmap
From protocol-shaped architecture toward an accessible, executable operating system for cooperative institutions, starting with single-institution truth and growing into federation only after governance and economics are real locally.
Core Principle
Build downward toward operable institutional reality, and upward only when the lower layer is honest.
The product is not "a protocol." It is a cooperative operating environment. Not just identity. Not just governance. Not just payments. Not just contracts. The real thing is the composition of those parts into institutional workflows:
- join an institution
- prove membership / role / trust
- propose something
- deliberate and vote
- allocate resources
- record obligations
- execute an outcome
- audit what happened
- federate that process across groups
Development is organized around institutional workflows, not subsystem elegance.
North Star
Make it easier to run a democratic, collectively owned institution than to patch one together with capitalist admin tools.
Not ideology versus ideology. Infrastructure versus infrastructure.
The moment ICN lets a cooperative run itself more clearly, more safely, and more democratically than the Google Docs + Stripe + Slack + bank account + treasurer spreadsheet mess, it stops being a theory project.
Phase 1: Make One Institution Real
Threshold: One real organization can use ICN to run meaningful governance and economic coordination without falling back to Google Docs, Stripe, Discord, and a treasurer's spreadsheet.
Capabilities Required
- Member identity exists
- Institution membership exists
- Roles and permissions exist
- Proposals can be created, discussed, voted, and finalized
- Passed proposals trigger real state changes
- Treasury or budget actions can be requested and approved
- Allocations, obligations, and settlements are durably recorded
- A user can inspect what happened and why
Done Means
A real institution can run:
- Member admission/removal
- One budget approval flow
- One allocation or settlement flow
- One policy change that actually changes permissions or behavior
Not Yet
- Broad federation
- Advanced market logic
- Generalized treaty systems
- Multi-domain civilization abstractions
Because if one institution cannot run cleanly, everything above it is theater.
Phase 2: Governance Must Compile Into System Behavior
Goal: A passed proposal changes something real.
Priority Implementation Pattern
Every major proposal type maps to an executable state transition:
| Proposal Type | Effect |
|---|---|
| Add/remove member | Membership roster changed |
| Assign/revoke role | Permissions altered |
| Approve budget | Budget line authorized |
| Authorize disbursement | Release executed |
| Change treasury rule | Policy updated |
| Modify institution policy | Constraints reconfigured |
| Approve federation relationship | Treaty activated |
| Commons usage policy | Access rules changed |
Required Architecture
- Proposal types with explicit effect models
- Validation before voting closes
- Deterministic execution after passage
- Durable recording of execution result
- Failure handling that is legible, not silent
Done Means
The system can prove:
- Who proposed it
- Who voted
- Why it passed
- What state changed
- Whether execution succeeded or failed
- What the post-change state is
Not Yet
- Highly dynamic arbitrary execution
- Universal contract engine replacing all domain logic at once
Explicit, bounded proposal-effect types first. Generalization comes later.
Phase 3: Institutional Economics, Not Consumer Payments
Goal: Make ICN useful for collective provisioning and accountable resource coordination. Avoid becoming left fintech.
Core Economic Primitives
- Treasury/budget lines
- Requests for allocation
- Approval and release conditions
- Recurring obligations
- Member dues or contribution commitments
- Mutual credit between actors or subgroups
- Escrow/release logic
- Durable settlement history
The Economic Layer Should Answer
- What resources exist?
- What has been committed?
- Who approved what?
- What remains available?
- What obligations are outstanding?
- What conditions govern release?
- How do we coordinate provision without defaulting to commodity purchase?
First Bounded Tranche
One honest institutional treasury path:
- Create request
- Review request
- Governance approval
- Execute release or obligation creation
- Record result in ledger
- Expose via API/UI
Done Means
A real institution can manage shared funds or internal credits with governance-backed authorization and auditability.
Not Yet
- Speculative tokenomics
- Retail wallet obsession
- Generalized exchange systems
- "Economy layer" abstractions without institutional use
The first question is not "can two strangers transact?" It is "can a cooperative govern and allocate common resources responsibly?"
Phase 4: Design Everything for the Human Interface Now
Goal: Backend structures support a future where most people interact through a phone, and many users are nontechnical or disabled.
Development Filter
Before adding backend complexity, ask:
- Can this be explained in plain language in the UI?
- Can a user understand what action they are authorizing?
- Can a user inspect why the system accepted or rejected something?
- Can this be represented accessibly on mobile?
- Does this create hidden operator dependency?
Priority Surfaces
- Human-readable action summaries
- Plain-language proposal descriptions
- Explicit permission/state explanations
- Accessible audit history
- Notification/event model suitable for mobile
- Role-aware dashboards: member, steward, treasurer, delegate
Done Means
A user can: join, see what they can do, review a proposal, vote, view treasury-related actions, understand outcomes without reading code.
Not Yet
- Pixel-perfect polished app
- Premature frontend expansion across every platform
Legibility first, polish second.
Phase 5: Earn Federation
Goal: Allow real institutions to interoperate without surrendering autonomy.
Order of Operations
- Institution can govern itself
- Institution can manage internal economic actions
- Institution can expose legible state and rules
- Then institutions can recognize and coordinate with one another
First Federation Capabilities
- Institution identity
- Federation relationship records
- Shared recognition/trust rules
- Inter-institution agreements
- Scoped obligations across institutions
- Auditable cross-institution actions
Done Means
Two institutions can enter a governed relationship and execute a bounded shared workflow with durable records and clear permissions.
Not Yet
- Global spontaneous federation
- Open-ended network complexity
- Abstract distributed choreography for its own sake
Do not network illusions together.
Phase 6: CCL as Institutional Grammar
Goal: CCL becomes the legible, executable expression layer for institutional rules, obligations, permissions, and coordination.
What CCL Should Eventually Express
- Membership conditions
- Quorum rules
- Voting thresholds
- Treasury release policies
- Recurring obligations
- Steward permissions
- Resource access policies
- Federation agreements
- Conflict resolution paths
- Commons governance rules
Constraint
CCL must remain readable by serious non-programmer operators. If only priest-engineers can author or audit it, power recentralizes.
Done Means
An institution can inspect its own rules in both machine-executable form and human-readable civic form.
Not Yet
- Universal everything-language
- Overpowered syntax before good authoring and review models
- Expressive complexity beyond operator comprehension
CCL should become governance law you can run, not magical incantation syntax.
Development Spine
Track A: Institutional Core
Members, roles, permissions, institution state, audit history
Track B: Governance Execution
Proposals, voting, tally/finalization, deterministic effect handlers, visible outcomes
Track C: Treasury / Resource Coordination
Requests, approvals, releases, obligations, settlements, balances/budgets
Track D: Human Surface
Plain-language summaries, accessible event feed, mobile-friendly APIs, explainable errors, status/notification model
Track E: Federation
Institution-to-institution trust, agreements, scoped cross-boundary actions, shared auditability
Track F: CCL
Rule templates, executable policy bindings, readable governance/economic contracts, versioned institutional law
Milestones
Milestone 1: Minimum Viable Cooperative
One institution can govern membership, vote, authorize a treasury action, and audit the result.
Milestone 2: Operational Commons
One institution can manage recurring obligations, budget logic, and role-governed stewardship through ICN.
Milestone 3: Accessible Member Interface
A nontechnical user can participate from a phone and understand what they are doing.
Milestone 4: Federated Cooperation
Two or more real institutions can coordinate through governed agreements.
Milestone 5: Institutional Grammar
CCL expresses the rules of institutional life in legible executable form.
Explicit Deprioritizations
- Sprawling protocol expansion without user workflows
- Symbolic decentralization features
- Speculative token/economy complexity
- Federation demos that outpace institutional truth
- Overly abstract contract machinery
- Polishing provenance forever while operability lags
- Frontend glitter over backend dishonesty
- Adding endpoints that do not correspond to real capability
Current Priority Order (as of 2026-03-25)
- Single-institution operability
- Governance-to-effect linkage
- Treasury/resource workflow
- Legible API/event surface
- Mobile/accessibility-informed backend design
- Federation of already-real institutions
- CCL gradual expansion
Next Implementation Tranche
Governance→Execution Bridge (FreezeMember)
When POST /gov/proposals/{id}/close finalizes a FreezeMember proposal as
Accepted, the target member is frozen in the cooperative's ledger with governance
provenance. This is the first proof that ICN governance compiles into execution.
See docs/strategy/operability-audit-2026-03-25.md for the full system audit and
ranked implementation queue.