827 Documents Synced
Documentation
Everything you need to understand, deploy, and contribute to the InterCooperative Network. These docs are synced directly from the main repository.
Developers
Start with Getting Started
Build the workspace, orient in the repo, and find the right contributor path without getting lost.
ContributorsUse the engagement map
Route yourself into docs, design, testing, research, institutional collaboration, or ecosystem work.
SupportersSupport the work
GitHub Sponsors is the live public support rail today for sustaining the project’s engineering work.
Choose a docs path
If you do not yet know what to search for, start here. Each path is a short reading sequence built from existing pages and docs.
-
Understand the project
What ICN is, what problem it addresses, and how the closure loop holds the institution together.
-
Build or contribute
Get the workspace running and find a contribution path that matches the repo as it actually exists.
-
Run infrastructure
Deployment routing, K3s, and the public domain map for nodes, gateways, and short links.
-
Understand governance
How proposals, decisions, mandates, and the kernel-app boundary actually work in ICN.
-
Understand economics and resource governance
The vocabulary discipline (obligation / allocation / settlement) and the draft RFC that frames external bridge institutions.
-
Understand federation
How distinct cooperatives coordinate without merger — treaties, attestations, and cross-institutional clearing.
-
Understand design and accessibility
The cross-surface design system, content style discipline, and accessibility floor for member-facing surfaces.
-
Check current project state
Honest, dated maturity. Read this before treating any subsystem as production-ready.
/
Core
- ICN Architecture Reference
- ICN Design Principles
- ICN Development Control System
- Documentation Maintenance Guide
- ICN Document Registry (human summary)
- Getting Started with ICN
- ICN Golden Prompt (Archived)
- ICN Documentation Index
- ICN Documentation Index
- ICN Overview — What It Is and How It Works
- ICN Phase History
- ICN Phase Progress
- ICN Documentation
- ICN Documentation Reorganization 2026
- ICN State (living doc)
- ICN Session Sync Log
- ICN TODO (ordered)
- Constitutional Genesis
- ICN Glossary
ADR
- ADR-0001: Orchestration Plane Architecture (icn-ops)
- ADR-0002: MCP Server Registration via ~/.mcp.json
- ADR-0003: IPv6 Dual-Stack Transport with Endpoint Sets
- ADR-0004: ICN Base Layer Models Obligations and Attestations, Not Payment Rails
- ADR-0005: Commons Credit Settlement Architecture
- ADR-0006: Compliance Chain — Verifiable State Architecture
- ADR-0007: Commons Resource Policy — CCL Formula Extraction
- ADR-0008: Receipt Chain Vertical Slice and Audit Verify
- ADR-0009: Happy Eyeballs — IPv4/IPv6 Connection Racing Within Endpoint Categories
- ADR-0010: App topology and canonical app roots
- Canonical Truth Ownership — Gateway vs Supervisor
- Federation State Origin Model — Gateway vs Governance vs Compute
- Federation Clearing Adoption Contract — Step 3 Architecture Design
- Constitutional Object Model — AuthorityClass, AuthorityGrant, TypedScope, Mandate
- ADR-0015: Service Discovery Auth Semantics — Auth-gated with Enumeration-Safe 404
- ADR-0016: Admin Merge Exception Policy for GitHub Runner Pool Saturation
- Monorepo Consolidation with Explicit Internal Boundaries
- ADR Lifecycle and Canonical Decision Index
- Authority Grant Minting and Mandate Persistence Seam
- Institutional Bootstrap Activation and Standing Read Model
- CCL Determinism, Fuel, and Capability Safety
- CCL Schema Bridge and Constraint Compilation
- CCL Institutional Process Language
- Institution Package Manifest Schema
- Institutional Effect Record Canonical Schema
- Receipt and Provenance Proof Envelope
- Action Card Contract
- Accessibility Baseline for Member Interfaces
- Conflict Resolution Object Model
- Compute Workload Manifest and Authority Boundary
- Commons Compute Admission and Settlement Policy
- Website Truth Boundary
- Public Maturity Claims and Evidence Links
- ADR Candidate Registry as Architectural Memory
- Short Decision Title
Ai
Architecture
- Abuse-case hardening strategy
- ICN Architectural Gaps & Weaknesses - Analysis & Remediation Plan
- ICN Architecture Comprehensive Audit - 2025-12-17
- ICN Architecture Review - Complete Coverage Checklist
- ICN Architecture Completion Status
- Architecture due diligence
- ICN Architecture Documentation Index
- ICN Complete Architecture Map
- ICN Architecture Quick Reference Card
- ICN Architecture Review & Post-Quantum Integration - Session Summary
- ICN Complete Architecture Review - Executive Summary
- Architecture Update - December 17, 2025
- ICN Visual Architecture Reference
- ICN Architecture Wiring Audit
- Auth Bridge and DID Login
- Canonical Encoding Specification
- Cells & Scopes Architecture
- ICN Client and Wallet Architecture
- Complete Architecture Audit - December 17, 2025
- Comprehensive Architecture Review
- Cooperative Domain Infrastructure
- Cooperative Tool Commons
- Debian Appliance Model
- Domain Routing and DNS Bindings
- Federation Actions Specification
- Federation Interoperability Contract
- Governance State Machine Specification
- ICN Integrated System Model
- Identity and Membership Architecture for ICN
- Implementation Gap Analysis
- Institutional Feedback and Support Primitives
- Institution Package Boundary
- Kernel/App Separation Architecture
- Member Standing and Accessible Participation
- Model Workloads and Deliberation
- Protocol Selection for Member Services
- Architecture Documentation
- Scope-Bounded Trust: Structural Centralization Prevention
- Service Hosting Model
- Session Summary: Architecture Review & Gap Closure
- Architecture Review & Gap Analysis Session - December 17, 2025
- The Commons
- Meaning Firewall Phase 2 Audit
Archive
- Sprint Status: 2025-12-25
- ICN Comprehensive Code Review - Complete Report
- Commons Evolution Implementation Summary
- ICN Demo - Current System Status
- Final CI Resolution Report 🎯
- 🎉 ICN Demo Wiring - SUCCESS!
- Final Session Status - 2025-12-18
- ICN Foundational Review - December 16, 2025
- Governance→Ledger Integration: Bugs & Issues Found
- Governance → Ledger Integration - Session Summary
- ICN: Complete Architecture Synthesis
- ICN: Minimum Vertical Slice
- ICN Real-World Deployment
- Kubernetes Deployment Guide
- ICN Next Sprint: Production Hardening & Deployment
- Phase 18: Pre-Pilot Hardening - COMPLETE ✅
- ICN Production Deployment Guide
- ICN Project Status - Comprehensive Assessment
- Archive: 2025
- ICN Refinement Sprint - Complete Summary
- ICN Refinement & Documentation Sprint
- ICN Gap Remediation Sprint Plan
- Sprint 1 Progress Report
- Sprint 2 Complete! 🎉
- Sprint 2 Progress - Dashboard Implementation
- Sprint 3 Progress Report
- Sprint 3 Day 1 Complete! 🚀
- Sprint 3: Deployment & Integration
- Sprint 3: Production Readiness - Status Report
- ICN Pilot-Ready Features Sprint - COMPLETE ✅
- Sprint Complete: Gap Closure Initiative
- Sprint Complete: Pilot-Ready Platform Features
- ICN Architecture Summary
- ICN System Gaps - Comprehensive Analysis
- 🎉 **ALL TESTS FIXED!** 🎉
- ICN Kernel/App Separation Transition Plan
- Bug Report: Code Review Session
- Follow-Up Issues for HSM/TPM Backend Implementation
- HSM/TPM Backend Roadmap
- Phase 16B: Placement Scoring - Implementation Progress
- Phase 16C: Locality Awareness - Implementation Plan
- Security Audit Resolution - December 18, 2025
- Security Hardening Session - December 18, 2025
- TPM 2.0 Implementation Plan
- TPM 2.0 Setup Guide
- ICN Forward Plan — March 2026
- ICN Golden Development Prompt
- ICN project state snapshot (2026-02-09)
- Archive: 2026
- ICN Roadmap
- ✅ ICN Demo - All Systems Green Report
- ICN Demo Readiness Audit
- 🎉 ICN Demo Wiring - ROOT CAUSE FOUND!
- ICN Demo Preparation - Current Status & Next Steps
- ICN Demo Session - Final Summary
- 🎊 ICN Demo Preparation - FINAL STATUS
- Fix "Session Expired" Error
- 🎉 ICN Demo Infrastructure - COMPLETE!
- ICN Demo - Login Credentials
- ICN Demo - Immediate Pivot
- ICN Demo - Immediate Next Steps
- 🎯 ICN Demo Progress - Session Update
- 🚀 ICN Demo - Quick Start Card
- ICN Demo Preparation - Document Index
- Fix Service Worker Caching Issue
- ICN Demo Wiring - Session 1 Summary
- 🎉 ICN Demo Preparation - Session Complete!
- ICN Demo Prep - Current Status Summary
- 🎉 ICN Demo - Complete End-to-End Success!
- ICN Demo Wiring - Session 1 Status
- Archived planning scratch (2026)
- CCL + Disputes — Repo State & Gap Analysis
- Constitution / Rights — Repo State & Gap Analysis
- Economics / Treasury — Repo State & Gap Analysis
- Governance / Receipts — Repo State & Gap Analysis
- Human Interface — Repo State & Gap Analysis
- Security / Ops / Resilience — Repo State & Gap Analysis
- Documentation Archive
Contracts
Demo
Deployment
- ICN Deployment Active
- ICN Deployment - Complete Guide
- ICN Deployment Guide
- ICN Invite System - Deployment Guide
- ICN Deployment Ready - December 12, 2025
- ICN Deployment Status - December 12, 2025
- Deploy ICN Test Network
- ICN Invite System - K3s Deployment Guide
- Full Stack Deployment Guide
- icn.zone Domain Routing Plan
- ICN Quick Deploy Reference Card
- 🚀 ICN Quick Start - Full Stack
Design
- ICN Accessibility Baseline
- Agent Handoff: Deterministic Compute Sprint
- Claude Design — ICN Context
- Claude Design — ICN Setup and Workflow
- RFC: ICN Commons Evolution
- Compute Substrate Vertical Slice - Implementation Status
- ICN Content Style Guide
- ICN Deterministic Compute Sprint
- ICN Commons Design System
- ICN Prompt Library
- ICN Visual Explainer Bible — v0
- ICN Visual System
- Minimal Viable Coop (MVC) Track
- Organizer / member accessibility gate
- Design Documentation
- ICN Visual Asset Register
- ICN Visual Assets — Planning Layer
- ICN Visual Review Checklist
- VE-001 — How ICN Works / Closure Loop
- VE-002 — Where You Are Acting / Scope Model
- VE-003 — Decision to Receipt / Provenance Trail
- VE-004 — Member Shell Concept
- VE-005 — Kernel / App Separation
- Capability-Based Feature Gating
- Compute Classes: Legitimacy Compute vs Utility Compute
- Compute Substrate Design
- ICN Deterministic Core (ICN-DC) Specification
- Dual-Foundation Minimal-Seams Slice
- ICN Economic Architecture
- ICN Economic Vision
- Economic Design Documentation
- Commons Credit Enforcement V1 — Implementation Note
- Contribution Credits: Infrastructure Incentives Design
- Economic Modeling for Mutual Credit Systems
- ICN Economic Safety Mechanisms
- ICN Economics Subsystem — Truth Contract
- Economic Model Validation
- Entity Dissolution: Before and After
- Entity Dissolution Workflow
- Execution Bridge Specification
- ICN Project Governance
- Governance Design Documentation
- Governance Primitives
- Governance:Write Decomposition — Design
- Governance Primitives
- Governance Model Validation
- Trust-Graph Integration for Witness Validation
- Institution-in-a-Box
- Institutional Structure + Event Model — Design Spec
- IPv6 Dual-Stack Transport and Endpoint Sets Design
- Multi-Device Identity Design (Phase 11)
- NAT Traversal Design
- ICN Platform Layer Design
- Post-Quantum Cryptography in ICN
- Razeto's Four Intercooperative Bodies: ICN Integration Design
- Regulatory-Safe Verifiable State Architecture
- ICN Repo Reality Map
- ICN Scheduler Evolution Plan
- Scope Scheduling: Capacity Slices and Preemption
- SDIS Design Documentation
- Social Recovery Guide
- Session Handoff — 2026-02-17
- Social Recovery Design
Design Language
Dev
- ICN Handoff Template
- Multi-Agent Git Worktree Workflow
- Session Handoff — 2026-04-10
- Session Handoff — 2026-04-15
- Session Handoff — 2026-05-05-b
- Session Handoff — 2026-05-05-c
- Session Handoff — 2026-05-05
- Session Handoff — 2026-05-07-a
- Session Handoff — 2026-05-07
- Session Handoff — 2026-05-14 (artifact registry and scoped vault spec)
- Session Handoff — 2026-05-14 (CCL policy registry and hook contract)
- Session Handoff — 2026-05-14
- Session Handoff — 2026-05-14 (effect dispatch contract)
- Session Handoff — 2026-05-14 (entity-scope vocabulary boundary)
- Session Handoff — 2026-05-14 (governed service binding spec)
- Session Handoff — 2026-05-14 (institutional domain spec)
- Session Handoff — 2026-05-14 (storage durability policies spec)
- Session Handoff — 2026-05-15 — Architecture-Spec Sprint Wrap
- Handoff — Compute Placement Policy Spec (#1801)
- Session Handoff — 2026-05-15
- Session Handoff — 2026-05-15
- Session Handoff — 2026-05-15
- Session Handoff — 2026-05-16 — Abuse-Case Hardening Strategy
- Session Handoff — 2026-05-17 — Appliance Verification
- Handoff — Thursday meeting prep truth packet — 2026-05-17
- ICN UX Language Guide
Development
- Development Documentation
- ICN Release Process
- Sprint Receipts: Stages 3–7 (Compute Substrate Vertical Slice)
- Code Quality Improvement Tracker
- CommonsManager Persistence — Execution Checklist
- CommonsManager Persistence — Design Doc
- Start Here Tomorrow — CommonsManager Persistence
- CommonsManager Persistence — Testing Plan
- ICN Federation Roadmap - Implementation Guide
- Gossip Message Migration to SignedEnvelope - Analysis Report
- IdentityBundle Refactor Plan
- Module Splitting Analysis
- Module Splitting Implementation Guide
- Module Splitting Analysis - Executive Summary
- Development Journal: Phase 0 Bootstrap
- Phase 1: Identity & Trust Infrastructure
- Development Journal: Prometheus Metrics Implementation
- Phase 2: Network Layer & Security Hardening
- Phase 3: CLI Management Tools & Production Features
- Phase 5: Gossip-Based Distributed Synchronization
- Phase 6: Network Protocol Bridge
- 2025-01-11: Phase 7 - Gossip Pull Protocol Implementation
- Phase 7 - Ledger Merge Report & Digest Emission
- Dev Journal: Production Hardening Phase 7
- Phase 7 Production Hardening - Session 2
- Phase 7: Pull Protocol Completion & Integration Testing
- Phase 7 - Pull Protocol Implementation
- Trust-Gated Rate Limiting Implementation
- User Onboarding Scaffolds - Phase 1
- Phase 10A - Contract Signature Verification & File Format
- Phase 10B Bug Fixes - Contract Deployment Integration
- Phase 10B: RPC Integration and CLI Tooling
- Phase 10C - Multi-Party Contract Signatures
- Phase 10C Production Hardening - Security Fixes & Test Coverage
- Phase 8A: Trust Network Propagation
- Phase 8C: Trust-Gated Gossip Topic Subscriptions
- Phase 9 - Contract Execution Engine Foundation
- Phase: Federation Foundations - Development Journal
- ICN Codebase Phase Status Report
- Trust-Gated Rate Limiting - Completion & Demo Infrastructure
- Critical Fix: TLS Certificate Persistence in Keystore Migration
- Federation Foundations: Topology-Aware Networking and RPC Improvements
- Gossip Message Authentication with SignedEnvelope
- Phase 10: End-to-End Payload Encryption
- Phase 8: DID-TLS Binding & Keystore Integration
- Phase 9: Message & Identity Integrity
- 2025-11-13: Topology Integration Tests & Bidirectional Handshake
- Phase 11: Multi-Device Identity & Sync
- Track B1: Graceful Restart Implementation
- Dev Journal: Track B1 Operational Hardening & Phase 12 Economic Safety Rails
- Phase 14 Gateway API - Production Hardening
- NAT Traversal Phases 1-3 Completion
- Phase 6: Security & Production Hardening
- Phase 16A: Scheduler Evolution Foundation
- Phase 16B: Metrics & Submitter API (Session 3)
- Phase 16B: Placement Negotiation Implementation
- Phase 16C Week 1: Network Topology Foundation (COMPLETE ✅)
- Phase 16C Week 4: Integration & Documentation
- Phase 16E Week 1: Cooperative Scheduling Policy Design
- Internal Testing Infrastructure: Pre-Pilot Validation
- Phase 4: NAT Traversal, Supervisor Modularization & Locality Integration
- Session Handoff - 2025-12-14
- Final Session Summary - 2025-12-14
- Final Session Summary - Continued Implementation
- ICN Final Status Report
- Foundational Review Session - December 16, 2025
- Gap Closure Session - December 17, 2025
- Gap Closure Session - December 17, 2025 - Final Report
- Gap Closure Session - 2025-12-17
- Gap Discovery & Closure Session - 2025-12-17 (Part 2)
- Gap Remediation Session - December 17, 2025
- Architecture Gap Remediation - Session Summary
- ICN Mobile App Integration - COMPLETE ✅
- Mobile App Integration Session - December 12, 2024
- ICN Invite System - Complete Implementation ✅
- ICN Invite System - Final Status Report
- Phase 1 Complete: Offline Mode + Error Handling
- Mobile App Integration Progress - Session Summary
- Phase 2: Push Notifications - Backend Implementation Complete ✅
- Session Status Report - 2025-12-14
- Development Session Summary - 2025-12-14
- Session Complete: Mobile Wallet Integration & Full-Stack Deployment
- Session Complete Status - December 12, 2024
- ICN Deployment Session - December 12, 2025
- Mobile Integration Complete - Session Summary
- Mobile Integration Session - December 12, 2025 (Final)
- Mobile App Integration Session Summary
- Mobile App Integration - Session Progress
- Session Summary: SDIS Implementation Progress
- 🎉 SDIS Phase 2 Session Complete
- ICN Architecture Review Session Summary
- Session Summary: Architecture Audit & Critical Fixes
- 🎉 Three Phases Complete: Production-Ready Mobile Infrastructure
- Phase 3: Trust Graph Integration - COMPLETE ✅
- WebSocket Event System Complete
- Work Session Summary - December 18, 2025
- Gateway Integration into icnd - Development Journal
- Phase 13 - Governance Daemon Integration
- Phase 14: Gateway API - Development Journal
- Development Journal: Strategic Pivot to Platform Layer
- Development Journal: Strategic Gap Analysis
- Development Journal: Governance → Contract → Ledger Integration
- Phase 2 Trust Extraction - Assessment & Path Forward
- Phase 2 Trust Extraction - Status Summary
- Phase 16D Week 2: Checkpoint Protocol & Storage
- Phase 16D Week 3: Migration Protocol & State Machine
- Phase 16D Week 4: Production-Ready Migration Features
- Phase 1 Complete: icn-api Shared Service Layer Foundation
- Trust Computation Algorithm Unification
- Session Handoff — 2026-03-22
- Session: Zenith ops recovery + sprint tracking truth-up
- Comprehensive Implementation Audit - December 17, 2025
- Actual Implementation Status
- Actual Implementation Status Audit
- ALL GAPS CLOSED - Final Session Summary 2025-12-17
- Gap Closure Complete - Session 2025-12-17
- CI Final Status - All Green ✅
- CI Status Report
- CI Status Report - December 18, 2025
- ICN Comprehensive Code Review
- Code Review Fixes - 2025-12-18
- 🎉 COMPLETE VICTORY - All Architecture Gaps Closed!
- ICN Comprehensive Gap Analysis
- CooperativeEntity Type Specification
- Cooperative Middle Layer: Gap Analysis
- CoopActor Integration - COMPLETE ✅
- CoopActor Integration Plan
- ICN Deep Dive Gap Analysis - 2025-12-17
- Deployment Infrastructure Note
- ICN Development Plan 2026
- E2E Testing Session - 2025-12-19
- CoopActor Integration - Final Status Report
- ICN Pilot Features Sprint - Final Summary
- ICN Architecture - Final Status Report
- Gap Closure - Final Status
- Gap Closure Complete - December 17, 2025
- Gap Closure Final Status - Session 2
- Gap Closure Progress - Session 3
- Gap Closure Progress - Session 4 (DR Testing)
- Gap Closure Progress Update
- Gap Closure Status Report
- Gap Remediation Complete - December 17, 2025
- Gap Remediation Roadmap - ICN Architecture Completion
- Architecture Gap Remediation Session - 2025-12-17
- Handler Extraction Refactoring - 2025-12-20
- ICN + SDIS Integrated Vision
- ICN Implementation Audit - December 17, 2025
- Implementation Reality Check
- ICN Implementation Reality Check
- CoopActor Integration Progress
- Mobile App Deployment Test Results
- Next Steps - Quick Reference
- Next Steps: Priority Roadmap
- ICN Post-Quantum Integration - Final Status Report
- Post-Quantum Cryptography Integration - Complete
- Priority Gaps to Fix Before Pilot
- 🎉 Push Successful - Session Complete
- Quick Start: CoopActor Integration
- ICN - Real Implementation Gaps
- ICN Refinement Session - Quick Reference
- ICN Development Session - Complete Summary
- Session Continuation - Documentation Integration
- Session: Init Refactoring (2026-02-01)
- Session Complete - Pilot Features Sprint
- Session Summary: OpenAPI Implementation & Sprint 3 Progress
- Gap Closure Session Summary - Snapshot Coordination
- ICN Feature Sprint Handoff Document
- Steward System Integration Status
- ICN Strategic Alignment Audit
- ICN Technical Debt & Gap Analysis
- ICN Technical Debt Improvement Plan
- ICN Technical Debt Update
- Phase 5: Membership Consolidation - Implementation Complete
- Sprint Documentation
- Sprint Plan - 2026-02-18
- Sprint Plan - 2026-02-19
- Sprint Plan - 2026-02-20
- ICN Beta Testing Guide
- ICN Disaster Recovery Test Results
- Internal Testing Plan: Multi-Node Network Validation
- Testing Documentation
- ICN Internal Testing Quick Start Guide
- Gossip Proof Layers
- Governance Proof Layers
- Ledger Proof Layers
- Testing RPC Communication
- Trust Proof Layers
- ICN 4-Layer Verification Pattern
- Trust Multi-Graph Migration Guide
Guides
- Frequently Asked Questions (FAQ)
- ICN Invite System - Quick Reference
- ICN Development Environment
- Documentation Style Guide
- Developer Guides
- Agent MCP tooling (icn-ops)
- Cursor and Claude MCP Setup
- Internationalization (i18n) Migration Guide
- ICN Institution Setup Guide
- Onboarding Runbook
- ICN Pilot Cluster Operator Runbook
- Operations Guides
- Backup and Recovery Guide
- Backup and Restore: Operator Recovery Procedure
- ICN Daemon Mode with Governance Receipts
- NAT Traversal Pilot Test Guide
- NAT Traversal Operations Guide
- Network Policy Design — ICN K3s Cluster
- ICN Operations Guide
- Phase 0 Operational Monitoring
- Pilot Smoke Runbook
- ICN Replication Operations Guide
- Emergency Node Restart
- Data Recovery Procedure
- Version Upgrade Procedure
- Security Incident Response
- Troubleshooting Guide
- Secrets Rotation Procedure
- Pilot Vertical Slice Smoke
- ICN Operations Runbooks
- ICN Troubleshooting Runbooks
- User Guides
- Why ICN?
- Cooperative Setup Guide
- Summit Decision Registry Demo
Handoffs
Internal
- Internal Documentation
- ICN Docs System Migration — Context Pack
- ICN Document Registry Specification
- Bootstrap Registry and Canon Map
- Documentation System Migration PR Specification
- Doc Placement and Truth-Class Rules
- Agent Prompt Templates
- Wrapper Instruction for the Agent Context Bundle
- ICN Legal Considerations
- ICN Pilot Coordinator Guide
- ICN Pilot Deployment Limitations
- ICN Pilot Deployment Playbook
- ICN Pilot Readiness Gaps
- Docs Reality Audit - 2026-02-11
- ICN Project Gap Analysis
- ICN Gap Analysis
- Multi-Device Identity Support - Status Report
- Strategic Gap Analysis: Substrate to System
- Vision-to-Implementation Gap Analysis
Maintenance
Manual
- Foundational Manual Baseline Lock
- Foundational Manual: Deterministic Boundary Types
- Foundational Manual: Economic State Resolution
- Foundational Manual: Executable Baseline-Lock Loop
- Foundational Manual: Identity Recovery and Capability Leases
- Foundational Manual: State Projection and Compaction
- Foundational Manual: Trustless Client Boundary
- ICN User Manual
Migration Guides
Mobile
Onboarding
- ICN Developer Onboarding Curriculum
- Assessments
- Capstone: Local Two-Node ICN + Ledger Flow
- Lab 01: Workspace Setup
- Lab 02: Error Receipts and Tracing
- Lab 03: Mini Actor Runtime
- Lab 04: Firewall Oracle — THE KEYSTONE LAB
- Lab 05: Mini Ledger with Double-Entry and Quarantine
- Lab 06: Signed Envelopes with Replay Protection
- Lab 07: Gossip Sync with Vector Clocks
- Lab 08: Governance Flow — Proposal to Constraint Update
- ICN Systems Textbook
- Module Template
- 01: Environment Setup & Repository Navigation
- 02: Rust Through ICN's Lens
- 03: Errors and Tracing — Distributed Visibility
- Gate 1: Becoming a Reader
- 04: Actors and Concurrency
- 05: The Meaning Firewall — ICN's Central Design Principle
- 06: Persistence and Ledger — Time-Communication + Invariants
- Gate 2: Becoming a Fixer
- 07: Identity and Cryptography — Practical Crypto for ICN
- 08: Network and Gossip — Eventual Consistency Without Consensus
- 09: Governance and Contracts — Democratic Rule Changes
- Gate 3: Becoming a Builder
- 10: Federation and Operations — Production Deployment
- 11: Maintainer Skills — Reshaping Architecture Safely
- Capstone: Maintainer Demonstration
- ICN Common Patterns Reference
- Reading Map
- Module 0: Setup and Tooling
- Module 1: Rust Fundamentals
- Module 2: ICN Architecture Overview
- Module 3: Runtime and Actor Model
- Module 4: Identity and Trust
- Module 5: Network and Gossip
- Module 6: Ledger and Contracts
- Module 7: Gateway API and SDK
- Module 8: Web UI Integration
- Module 9: Operations and Deployment
- Module 10: Contributor Workflow
- Module 11: Federation and Inter-Cooperative Agreements
- Module 12: Observability and Metrics
- Module 13: Security and Privacy Layers
- Module 14: Governance and CCL Deep Dive
- Onboarding Resources
- Curriculum Gap Analysis and Iteration Plan
- Syllabus
- Accelerated Track (4 weeks)
- ICN Contributor Ladder
- Foundations Track (8 weeks)
- Curriculum Update Process
- Workshop 0: Local Build and Repo Orientation
- Workshop 1: Rust Fundamentals in Practice
- Workshop 2: Architecture Mapping Exercise
- Workshop 3: Runtime and Actor Lifecycle
- Workshop 4: Identity and Trust Hands-On
- Workshop 5: Network and Gossip Deep Dive
- Workshop 6: Ledger and Contract Flow
- Workshop 7: Gateway Auth and SDK Usage
- Workshop 8: Web UI Exploration
- Workshop 9: Local Deployment and Observability
- Workshop 10: Contributor Workflow Practice
- Workshop 11: Federation Hands-On
- Workshop 12: Observability and Metrics
- Workshop 13: Security and Privacy Layers
- Workshop 14: Governance and CCL Deep Dive
Operations
Ops
Performance
Phases
Pilots
Planning
Plans
- Planning scratch (relocated)
- UI Polish: Conference-Ready Demo — Implementation Plan
- ICN Point A → Point B: Civilizational Consensus Stack
- ICN Formal Research Agenda: Architectural Hurdles and Track Briefs
- B3: Allocation Receipt Chain Design
- B3: Allocation Receipt Chain — Implementation Plan
- C3 NAT Traversal Design
- C3 NAT Traversal Implementation Plan
- Sprint 11: Federated Governance Wiring — Implementation Plan
- Authz Capability Graph Design (Phase B)
- Authz Capability Graph (Phase B0) Implementation Plan
- Commons Credit Accounting Implementation Plan
- Sprint 14 Closeout + Sprint 15 Scope
- ICN Demo System Design
- ICN Federation Demo System — Implementation Plan
- Sprint 21: Meaning Firewall Policy Extraction Implementation Plan
- Agent Teams Launch Prompt: ICN Point A → Point B
Reference
- ICN Gateway API (developer reference)
- API Reference Documentation
- ICN API Versioning Guide
- Topic Subscriptions API
- CCL Charter Templates
- ICN Configuration Management Guide
- Configuration Reference Documentation
- Identity Backend Configuration
- Trust Threshold Configuration
- Entity Topology Patterns
- Governance Playbook
- Institution Package Bootstrap Contract
- ICN Project Index
- CCL Map
- CI / Ops / Deploy Map
- Current Truth Map
- Docs Control Map
- Full Repository Record Protocol
- Full Repository Record — `icn`
- Identity and Cryptography Map
- Network and Gossip Map
- Pilot UI Current State Map
- Project Coverage Matrix
- Remote coordination note (superseded sequencing)
- ICN Repo Atlas
- Runtime Surface Map
- Rust Workspace Map
- Service Hosting Map
- Show-Readiness Map
- Source-of-Truth Map
- Source Tree Map
- Stale and Archived Map
- Tool Commons Map
- Website Truth Map
Rfcs
SDIS
- SDIS API Guide
- SDIS Complete Build - Detailed Plan
- SDIS & Steward System - Deployment Status
- SDIS Implementation Complete
- SDIS Implementation Plan for ICN
- SDIS Complete Integration - Implementation Session
- SDIS Quick Start Guide
- SDIS Gateway API Implementation - Session Complete
- SDIS & Steward System Implementation Status
- SDIS + Steward System Status
- SDIS & Steward System - Completion Roadmap
- SDIS: Secure Distributed Identity System
- SDIS User Guide
Security
- Comprehensive Security Improvements - December 18, 2025
- Educational Guide: Security Code Review & Fixes
- Final Security Status - December 18, 2025
- Gateway Content Security Policy
- Security Documentation
- SDIS Code Audit Checklist
- SDIS Cryptographic Review
- SDIS Threat Model
- Secret Management Best Practices
- Security Analysis - Remaining Issues
- Security Audit Report - cargo-audit
- Security Audit Results - December 2024
- Security Fixes - December 18, 2025
- Security Follow-up Tasks
- Security Testing Guide
- TOFU (Trust-On-First-Use) Security Model
- Phase 10C Security Analysis & Production Hardening
- Production Hardening - Security & Stability
- ICN Security Roadmap
- ICN Threat Model
Spec
- ICN Kernel Contracts Specification
- Artifact Registry and Scoped Vault — boundary, v0 design
- CCL Policy Registry and Hook Contract
- Compute Placement Policy
- Effect Dispatch Contract
- Federation Settlement Finality Spec
- Governed Service Binding, Workload Manifest, and Runtime Provider
- InstitutionalDomain and DomainPolicy
- Member Shell v0
- Network Anti-Entropy Proof Loops
- Private-overlay DID activation flow (generic ICN spec)
- Steward Cockpit v0
- Storage Durability Policies — Backup, Replication, Recovery, Archive, Integrity
State
Status
Strategy
- ADR-001: What ICN Is
- Cooperative-developer discovery brief
- What ICN Is
- The Evolution of ICN: From First Thought to Coordination OS
- ICN System-by-System Gap Analysis: Vision vs. Reality
- ICN Institutional Operability Roadmap
- ICN: Digital Infrastructure for the Democratic Economy
- ICN Roadmap — Live
- ICN Roadmap & Strategy: From Solo Developer to Cooperative Infrastructure
- ICN in Practice: Six Scenarios
- Sprint Plan: Close the Demo Gap
- ICN Technical Whitepaper: Architecture of a P2P Constraint Engine for Democratic Organizations
- ICN Constitutional Roadmap
- ICN Thursday Meeting Brief — 2026-05-21
- Licensing strategy matrix (autonomy review)
- Sovereign Forge Strategy
- Grant Application Artifacts
- ICN Budget Skeleton
- ICN Compliance Architecture
- ICN Grant Narrative Core
- ICN: Digital Public Infrastructure for the Cooperative Economy
- ICN Milestones
- ICN Pilot Readiness Assessment
- ICN Institutional Ecosystem Arc
- ICN Operability Audit — 2026-03-25
- Sprint 24 Close — Commons-Compute Spine
Superpowers
- Sprint 23 — Baseline Lock + Narrative Surface — Implementation Plan
- Coverage CI Decision — p24-pre-2
- Flow 2 (Patronage) Pre-Sprint Repair Checklist
- Sprint 23 Design — Baseline Lock + Narrative Surface
- Sprint 24 Planning — Commons Compute Hardening
- Sprint 24 Execution Start — #925 Commons Compute Spine
- Zenith Temporary Coverage Runner Setup
- Sprint 27 Design: Demo-Ready + Compute Story