ICN Documentation Index

Canonical index of all ICN documentation, organized by category.

Quick Navigation


Architecture

๐Ÿ”’ Canonical ICN Vision Statement

Core vision, values, and long-term aspiration for InterCooperative Network

For: all | Updated: 2026-02-01

๐Ÿ”’ Canonical ICN Architecture Reference

Single authoritative architecture covering all 8 primitives, kernel-app separation, subsystems, and implementation status

For: developers, architects, grant-reviewers | Updated: 2026-03-21

๐Ÿ“ Living ADR-0010: App Topology

Architectural decision record on app topology

For: architects | Updated: 2026-03-10

๐Ÿ“ Living Architectural Gaps & Remediation Plan

Analysis of architectural weaknesses and remediation strategies

For: architects | Updated: 2026-03-10

๐Ÿ“ Living Canonical Encoding

Specification for deterministic serialization of ICN data structures

For: developers, architects | Updated: 2026-03-10

๐Ÿ“ Living Cells and Scopes Architecture

Design of ICN's cell-based organization model and scope hierarchy

For: architects, developers | Updated: 2026-03-15

๐Ÿ“ Living Client Model Architecture

Architecture of ICN client models and their relationship to kernel primitives

For: developers, architects | Updated: 2026-03-15

๐Ÿ“ Living Federation Actions

Design of federated action execution across network boundaries

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Federation Interoperability Contract

Specification of contracts and interfaces for federation interoperability

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Governance State Machine Architecture

State machine design for governance decision-making and enforcement

For: architects, developers | Updated: 2026-03-12

๐Ÿ“ Living Identity and Membership Architecture

Design of identity primitives, membership verification, and member lifecycle

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Kernel/App Separation Architecture

Normative specification of kernel-app boundary, infection vectors, and capability propagation rules

For: developers, architects | Updated: 2026-03-17

๐Ÿ“ Living Scope Bounded Trust

Trust model design limiting trust scope to organizational boundaries

For: architects, security | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Kernel Contracts Specification

Specification of kernel contract primitives

For: architects, developers | Updated: 2026-03-10

Design

๐Ÿ“ Living RFC: ICN Commons Evolution

Design for evolving ICN commons governance and stewardship models over phases 0-3

For: architects, stakeholders | Updated: 2026-03-15

๐Ÿ“ Living Minimal Viable Coop Track

Program for shipping one end-to-end cooperative use case for production 6-month validation

For: product, architects | Updated: 2026-03-15

๐Ÿ“ Living Capability-Based Feature Gating

System for graceful version handling via capability advertisement and negotiation

For: developers | Updated: 2026-03-15

๐Ÿ“ Living Compute Classes: Legitimacy vs Utility

Design distinguishing between legitimacy compute and utility compute subsystems

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Compute Substrate Design

Design for ICN's execution environment and compute resource management

For: architects, developers | Updated: 2025-11-18

๐Ÿ“ Living ICN Deterministic Core Specification

Specification for deterministic computation substrate ensuring reproducible state machines

For: developers, architects | Updated: 2026-03-15

๐Ÿ“ Living ICN Economic Architecture

Design of value flows, contribution accounting, and economic incentives

For: architects, product | Updated: 2026-01-17

๐Ÿ“ Living Economic Vision

Long-term vision for ICN's economic model and cooperative ownership

For: architects, stakeholders | Updated: 2026-03-10

๐Ÿ“‹ Draft Contribution Credits Design

Design for tracking and accounting for contributions to cooperative entities

For: architects | Updated: 2026-03-10

๐Ÿ“ Living Economic Modeling for Mutual Credit

Simulation and validation of mutual credit economic models

For: architects | Updated: 2026-03-10

๐Ÿ“‹ Draft Economic Safety Design

Safety mechanisms preventing economic attacks and misuse of economic primitives

For: architects, security | Updated: 2026-03-10

๐Ÿ“ Living Economics Truth Contract

Truth contract auditing all economics-related code against specification

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Economic Model Validation

Maps economic operations against implementation state

For: architects | Updated: 2026-03-10

๐Ÿ“ Living Entity Dissolution: Before and After

Practical example of entity dissolution workflow

For: architects | Updated: 2026-03-10

๐Ÿ“‹ Draft Entity Dissolution Design

Design for graceful shutdown and dissolution of cooperative entities

For: architects | Updated: 2026-03-10

๐Ÿ“ Living Execution Bridge Specification

Authoritative design for bridging between ICN and external execution environments

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living ICN Project Governance

Governance structure for ICN development and decision-making

For: team, stakeholders | Updated: 2026-03-10

๐Ÿ“‹ Draft Governance Primitives

Fundamental governance building blocks and decision-making patterns

For: architects | Updated: 2026-03-10

๐Ÿ“‹ Draft Governance Framework

Comprehensive governance framework for cooperative decision-making

For: architects, product | Updated: 2026-03-10

๐Ÿ“ Living Governance Model Validation

Maps governance operations against implementation state

For: architects | Updated: 2026-03-10

๐Ÿ“ Living Trust-Graph Integration for Witness Validation

Trust-graph integration for witness validation in ledger operations

For: architects, security | Updated: 2026-03-10

๐Ÿ“ Living Institution-in-a-Box

Design pattern for embedding ICN primitives into legacy digital infrastructure with CRDTs and replication

For: architects, product | Updated: 2026-03-15

๐Ÿ“‹ Draft IPv6 Endpoint Sets Design

Design for managing multiple network endpoints with IPv6

For: architects, developers | Updated: 2026-03-10

๐Ÿ“‹ Draft Multi-Device Identity Design

Design for managing identity across multiple devices within a single agent

For: developers, architects | Updated: 2026-03-10

๐Ÿ“‹ Draft NAT Traversal Design

Design for peer-to-peer connectivity across NAT boundaries

For: architects, developers | Updated: 2026-03-10

๐Ÿ“‹ Draft Platform Layer Design

Design for platform abstractions and portability across systems

For: developers, architects | Updated: 2026-03-10

๐Ÿ“‹ Draft Post-Quantum Cryptography in ICN

Experimental post-quantum cryptography integration and migration strategy

For: architects, security | Updated: 2026-03-10

๐Ÿ“‹ Draft Razeto Integration Design

Design for integrating external systems via Razeto protocol

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Regulatory-Safe Verifiable State

Design maintaining provable state satisfying regulatory audits without exposing ledger internals

For: architects, compliance | Updated: 2026-03-10

๐Ÿ“‹ Draft Repository Reality Map

Mapping between git repository structure and architectural reality

For: developers | Updated: 2026-03-10

๐Ÿ“‹ Draft Scheduler Evolution Plan

Plan for evolving ICN's scheduling substrate over multiple phases

For: architects | Updated: 2026-03-10

๐Ÿ“‹ Draft Scope Scheduling Design

Design for scheduling and resource allocation within organizational scopes

For: architects, developers | Updated: 2026-03-10

๐Ÿ“ Living Social Recovery Guide

M-of-N social recovery mechanism for identity recovery

For: architects, security | Updated: 2026-03-10

๐Ÿ“‹ Draft Social Recovery Design

M-of-N social recovery mechanism for lost devices and identity recovery

For: architects, security | Updated: 2026-03-10

๐Ÿ“‹ Draft Gossip SignedEnvelope Migration

Migration plan for gossip cryptographic authentication

For: developers | Updated: 2026-03-10

๐Ÿ“‹ Draft IdentityBundle Refactor Plan

Hardware-backed signing implementation plan

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module Splitting Analysis

Analysis of large modules for potential splitting

For: architects | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Mobile Member UX Spec v1

Mobile application UX specification

For: developers, product | Updated: 2026-03-10

๐Ÿ“‹ Draft SDIS: Secure Distributed Identity System

SDIS design with implemented flows and planned endpoints

For: architects, developers | Updated: 2026-03-10

Guide

๐Ÿ”’ Canonical Contributing to ICN

Architectural guardrails, contribution workflow, code standards, and review process

For: contributors | Updated: 2026-03-01

๐Ÿ”’ Canonical Getting Started with ICN

Quick-start guide for new developers to set up ICN in minutes

For: developers, contributors | Updated: 2026-03-15

๐Ÿ“ Living Deploy Test Network

Guide for setting up multi-node test networks for validation

For: developers, testers | Updated: 2026-03-10

๐Ÿ“ Living Deploy to K3s

Steps for deploying ICN to Kubernetes using K3s

For: operators, developers | Updated: 2026-03-10

๐Ÿ“ Living Quick Deploy Guide

Fast path for getting ICN running locally

For: developers, operators | Updated: 2026-03-10

๐Ÿ”’ Canonical ICN UX Language Guide

Enforced communications style guide for regulatory-safe messaging

For: all | Updated: 2026-03-10

๐Ÿ“ Living Federation Roadmap Implementation Guide

Step-by-step federation feature implementation guide

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Trust Multi-Graph Migration Guide

Migration guide for multi-graph architecture

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Witness Signature Best Practices

Developer guide for witness signature implementation

For: developers | Updated: 2026-03-10

๐Ÿ“ Living ICN Development Environment

Setup guide for icn-dev development VM

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Documentation Style Guide

Consistent documentation formatting standards

For: contributors | Updated: 2026-03-10

๐Ÿ”’ Canonical Developer Guides

Index of guides for developers building on or contributing to ICN

For: developers | Updated: 2026-03-10

๐Ÿ“‹ Draft Internationalization (i18n) Guide

i18n implementation across Rust, React Native, web

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Operations Guides

Operational guides for running ICN deployments

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Backup and Recovery Guide

Operator procedures for node backup and recovery

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Backup and Restore: Operator Recovery

Low-level Sled database and keystore recovery

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Daemon Mode with Governance Receipts

Phase 0 pilot daemon mode operations

For: operators | Updated: 2026-03-10

๐Ÿ“ Living NAT Traversal Pilot Test Guide

Manual testing guide for NAT traversal feature

For: operators, testers | Updated: 2026-03-10

๐Ÿ“ Living NAT Traversal Operations Guide

Configuring and operating nodes behind NAT

For: operators | Updated: 2026-03-10

๐Ÿ“ Living ICN Operations Guide

Comprehensive operational procedures and workflows

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Pilot Smoke Runbook

Deterministic operator check for pilot deployment

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Replication Operations Guide

Replication procedures for Phase 17 storage hardening

For: operators | Updated: 2026-03-10

๐Ÿ“ Living ICN Troubleshooting Runbooks

Step-by-step procedures for diagnosing operational issues

For: operators | Updated: 2026-03-10

๐Ÿ”’ Canonical User Guides

End-user documentation and tutorials

For: users | Updated: 2026-03-10

๐Ÿ“ Living Cooperative Setup Guide

Instructions for setting up a new cooperative on ICN

For: users | Updated: 2026-03-10

๐Ÿ“ Living Summit Decision Registry Demo

Demo script for decision registry and treasury spending

For: team, demo-users | Updated: 2026-03-10

๐Ÿ“ Living Pilot Coordinator Guide

Practical guide for cooperative coordinators deploying ICN

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Pilot Deployment Playbook

Step-by-step guide for pilot cooperative deployment

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft Keystore Version Migration

Guide for keystore format version migration

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Version Upgrade Guide

Guide for upgrading between ICN versions

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft Tail-Based Sampling Configuration

Tail-based sampling setup for traces

For: operators | Updated: 2026-03-10

๐Ÿ”’ Canonical Developer Onboarding Curriculum

Structured learning path for new ICN developers

For: developers, contributors | Updated: 2026-03-15

๐Ÿ“ Living Onboarding Assessments

Module checkpoints and self-review questions

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Capstone: Local Two-Node ICN + Ledger Flow

Final capstone project demonstrating end-to-end ICN

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 01: Workspace Setup

Learning lab for workspace organization

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 02: Error Receipts and Tracing

Learning lab for structured errors and tracing

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 03: Mini Actor Runtime

Learning lab for actor model implementation

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 04: Firewall Oracle (Keystone Lab)

Keystone lab proving the Meaning Firewall boundary

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 05: Mini Ledger with Double-Entry

Learning lab for ledger implementation

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 06: Signed Envelopes with Replay Protection

Learning lab for cryptographic signatures

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 07: Gossip Sync with Vector Clocks

Learning lab for eventual consistency

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Lab 08: Governance Flow

Learning lab for governance proposal to constraint update

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 01: Environment Setup & Repository Navigation

Foundational module on environment and repo layout

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 02: Rust Through ICN's Lens

Foundational module on Rust patterns used in ICN

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 03: Errors and Tracing

Foundational module on error handling and distributed visibility

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Actors and Concurrency

Learning module on ICN's actor model and concurrent execution

For: developers | Updated: 2026-03-10

๐Ÿ“ Living The Meaning Firewall

Learning module on ICN's type-safe boundary enforcement

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Persistence and Ledger

Learning module on state persistence and event logging

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 07: Identity and Cryptography

Systems module on identity and cryptographic operations

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 08: Network and Gossip

Systems module on network communication and eventual consistency

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 09: Governance and Contracts

Systems module on governance and contracts

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 10: Federation and Operations

Ownership module on federation and production deployment

For: developers | Updated: 2026-03-10

๐Ÿ“ Living 11: Maintainer Skills

Ownership module on reshaping architecture safely

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Maintainer Capstone

Final capstone gate for Maintainer tier

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Onboarding Reading Map

Links between modules and high-signal source files

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 0: Setup and Tooling

Reference module on development environment setup

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 1: Rust Fundamentals

Reference module on Rust concepts for ICN

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 02: Architecture Overview

Reference module providing high-level architecture overview

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 3: Runtime and Actor Model

Reference module on actor model and constraint engine

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 4: Identity and Trust

Reference module on identity and trust primitives

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 5: Network and Gossip

Reference module on network communication and state sync

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 6: Ledger and Contracts

Reference module on ledger and CCL programming

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 8: Web UI Integration

Reference module on web UI integration

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 9: Operations and Deployment

Reference module on production deployment

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 10: Contributor Workflow

Reference module on contribution processes

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 11: Federation

Reference module on federation and inter-cooperative agreements

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 12: Observability and Metrics

Reference module on monitoring

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Module 13: Security and Privacy

Reference module on security and privacy in ICN

For: developers, security | Updated: 2026-03-10

๐Ÿ“ Living Module 14: Governance and CCL Deep Dive

Reference module on governance and contract language

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Curriculum Gap Analysis

Analysis of curriculum gaps and iteration plan

For: team | Updated: 2026-03-10

๐Ÿ”’ Canonical Onboarding Syllabus

Overall course structure for Foundations and Accelerated tracks

For: developers | Updated: 2026-03-15

๐Ÿ”’ Canonical Accelerated Track (4 weeks)

Fast-track onboarding for Rust-intermediate developers

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical ICN Contributor Ladder

Tier-based contributor skill progression (Observer โ†’ Contributor โ†’ Maintainer โ†’ Architect)

For: contributors | Updated: 2026-03-10

๐Ÿ”’ Canonical Foundations Track (8 weeks)

Comprehensive onboarding track for Rust beginners

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Curriculum Update Process

Process for keeping onboarding aligned with codebase

For: team | Updated: 2026-03-10

๐Ÿ“ Living Workshop 0: Local Build and Repo Orientation

Workshop on local build and repository structure

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 1: Rust Fundamentals in Practice

Workshop applying Rust patterns to ICN code

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 2: Architecture Mapping Exercise

Workshop for building architecture mental models

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 3: Runtime and Actor Lifecycle

Workshop on actor model and lifecycle

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 4: Identity and Trust Hands-On

Workshop on identity and trust operations

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 5: Network and Gossip Deep Dive

Workshop on network and gossip systems

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 6: Ledger and Contract Flow

Workshop on ledger and contract operations

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 8: Web UI Exploration

Workshop on web UI and gateway integration

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 9: Local Deployment and Observability

Workshop on deployment and monitoring

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 10: Contributor Workflow

Workshop on contribution workflow

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 11: Federation Hands-On

Workshop on federation code paths

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 12: Observability and Metrics

Workshop on observability

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 13: Security and Privacy

Workshop on security and privacy layers

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Workshop 14: Governance and CCL Deep Dive

Workshop on governance and contract language

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Ops runbooks relocated (stub)

Runbooks moved to docs/guides/operations/runbooks/ (tranche 3); use that path for updates

For: operators | Updated: 2026-03-26

๐Ÿ“‹ Draft Pilot Proposal Template

Template for approaching potential pilot communities

For: team | Updated: 2026-03-10

๐Ÿ“ Living SDIS User Guide

End-user guide for credential presentation system

For: users | Updated: 2026-03-10

๐Ÿ“ Living Mobile App Testing Guide

Testing guide for mobile application

For: testers | Updated: 2026-03-10

Operations

๐Ÿ“ Living ICN Deployment Guide

Comprehensive guide for deploying ICN to production environments

For: operators, developers | Updated: 2026-03-15

๐Ÿ“ Living Code Quality Improvement Tracker

Tracks error handling and code quality audits

For: developers | Updated: 2026-03-10

๐Ÿ“‹ Draft Network Policy Design โ€” K3s

K3s network policy design (deferred)

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Phase 0 Operational Monitoring

Monitoring configuration for Phase 0 pilot

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Emergency Node Restart

Runbook for emergency node restart procedures

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Data Recovery Procedure

Runbook for node data recovery from backup

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Version Upgrade Procedure

Runbook for upgrading daemon to new version

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Security Incident Response

Runbook for security incident response

For: operators, security | Updated: 2026-03-10

๐Ÿ“ Living Troubleshooting Guide

Common issues and solutions for node operations

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Secrets Rotation Procedure

Runbook for rotating cryptographic secrets

For: operators, security | Updated: 2026-03-10

๐Ÿ“ Living Pilot Vertical Slice Smoke

Runbook for pilot deployment verification

For: operators | Updated: 2026-03-10

๐Ÿ”’ Canonical Operations Directory README

Navigation for operations and deployment documentation

For: operators | Updated: 2026-03-10

๐Ÿ“ Living Operations Deployment Guide

Deep operational guide for production deployments

For: operators | Updated: 2026-03-15

๐Ÿ“‹ Draft Distributed Tracing Setup

Configuration for distributed tracing and observability

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft Incident Response Plan

Procedures for responding to production incidents

For: operators | Updated: 2026-03-10

Reference

๐Ÿ“ Living Agent Registry

Catalog of authorized AI agents and their capabilities for ICN development

For: agents, team | Updated: 2026-03-01

๐Ÿ“ Living Changelog

Release notes and version history

For: contributors, public | Updated: 2026-03-21

๐Ÿ”’ Canonical Claude Agent Onboarding

Guidance for Claude Code sessions working with ICN codebase

For: agents, developers | Updated: 2026-03-21

๐Ÿ”’ Canonical Code of Conduct

Community guidelines and expected behavior for contributors

For: contributors, community | Updated: 2025-12-01

๐Ÿ”’ Canonical ICN - InterCooperative Network

Main project README with overview, quick start, and CI/CD status badge

For: contributors, public | Updated: 2026-03-10

๐Ÿ”’ Canonical ICN Documentation Control System

Normative development control plane: discovery vs delivery, artifact routing, and documentation governance

For: contributors, agents | Updated: 2026-03-26

๐Ÿ“ Living ICN Document Registry (human summary)

Auto-generated summary companion to registry.toml; run doc_control_check.py to refresh

For: contributors, agents | Updated: 2026-03-26

๐Ÿ“ Living ICN Golden Development Prompt

Master context and instructions for AI-assisted development on ICN

For: agents, developers | Updated: 2026-03-18

๐Ÿ”’ Canonical ICN Documentation Index

Master navigation and directory of all documentation with cross-references

For: all | Updated: 2026-03-15

๐Ÿ”’ Canonical Docs Directory README

Overview of documentation structure and navigation guide

For: contributors | Updated: 2026-03-10

๐Ÿ“ Living ICN Gateway API Documentation

HTTP API specification and usage guide for ICN Gateway

For: developers, integrators | Updated: 2026-03-15

๐Ÿ”’ Canonical API Documentation Index

Navigation and overview for API-related documentation

For: developers, integrators | Updated: 2026-03-10

๐Ÿ“ Living OpenAPI Specification

Machine-readable API specification in OpenAPI 3.0 format

For: developers, tools | Updated: 2026-03-15

๐Ÿ”’ Canonical Architecture Directory README

Navigation guide for architecture documentation

For: architects | Updated: 2026-03-10

๐Ÿ“ Living CI Current Status

Current state of all CI checks and gate enforcement levels

For: developers | Updated: 2026-03-10

๐Ÿ“ Living CI Gate Ratchet Plan

CI gates, ratchet phases, required checks, and failure index

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Demo System Documentation

Documentation for ICN demonstration system

For: team, demo-users | Updated: 2026-03-15

๐Ÿ”’ Canonical Design Directory README

Navigation guide for design documentation

For: architects, developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Economics Directory README

Navigation for economics and value flow documentation

For: architects | Updated: 2026-03-10

๐Ÿ”’ Canonical Governance Directory README

Navigation guide for governance documentation

For: architects | Updated: 2026-03-10

๐Ÿ”’ Canonical SDIS Design Documentation

Navigation guide for Sovereign Digital Identity System design

For: architects | Updated: 2026-03-10

๐Ÿ”’ Canonical Development Documentation

Navigation guide for development activities

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Testing Documentation

Navigation guide for testing guides

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Policy Examples

Example governance policies for cooperative organizations

For: users, architects | Updated: 2026-03-10

๐Ÿ“ Living ICN Glossary

Reference document with ICN terminology and definitions

For: all | Updated: 2026-03-10

๐Ÿ“ Living ICN Operations Runbooks

Navigation guide for production runbooks (domain hub; not control-plane canonical)

For: operators | Updated: 2026-03-26

๐Ÿ”’ Canonical Internal Documentation

Internal-only documentation for team coordination

For: team | Updated: 2026-03-10

๐Ÿ“ Living Imported documentation control context pack (readme)

Index and provenance for bundled control-system specs and templates source pack

For: contributors, agents | Updated: 2026-03-26

๐Ÿ“‹ Draft ICN Legal Considerations

Legal questions and considerations for cooperative communities

For: compliance | Updated: 2026-03-10

๐Ÿ“ Living Pilot Deployment Limitations

Known limitations and constraints in pilot phase

For: team | Updated: 2026-03-10

๐Ÿ“ Living Pilot Readiness Gaps

Critical gaps between implementation and pilot readiness

For: team | Updated: 2026-03-10

๐Ÿ“‹ Draft Storage Metrics Reference

Prometheus metrics for storage and database monitoring

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft Module Template

Template for creating onboarding modules

For: team | Updated: 2026-03-10

๐Ÿ“ Living ICN Common Patterns Reference

Quick reference for recurring code patterns in ICN

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Performance Documentation

Performance requirements, benchmarks, and optimization guidance

For: developers, architects | Updated: 2026-03-10

๐Ÿ“ Living Trust Score Benchmark Results

Benchmark results for trust score performance

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Trust Service Performance Characteristics

Performance characteristics and optimization guidance

For: developers | Updated: 2026-03-10

๐Ÿ“ Living Decision Registry + Treasury Vote Pilot

Economic receipt chain implementation in pilot

For: team | Updated: 2026-03-10

๐Ÿ“‹ Draft Hosted Pilot Approach

Approach for hosted cooperative pilot deployments

For: team | Updated: 2026-03-10

๐Ÿ“‹ Draft Agent Knowledge Architecture

Design for AI agent knowledge bases and context management

For: agents, architects | Updated: 2026-03-10

๐Ÿ“ Living ICN Crate Reference

Authoritative inventory of workspace crates

For: developers | Updated: 2026-03-10

๐Ÿ“ Living ICN Governance Demo One-Pager

One-page demo explanation and value proposition

For: stakeholders | Updated: 2026-03-10

๐Ÿ“ Living ICN Ecosystem Map

System component interconnection map

For: architects | Updated: 2026-03-10

๐Ÿ“ Living API Reference

Detailed API endpoint reference with examples and error codes

For: developers | Updated: 2026-03-15

๐Ÿ”’ Canonical API Reference Documentation

Navigation guide for API reference documents

For: developers | Updated: 2026-03-10

๐Ÿ“ Living API Versioning Strategy

Versioning scheme and compatibility policy for ICN APIs

For: developers, architects | Updated: 2026-03-10

๐Ÿ“‹ Draft Topic Subscriptions API

API for subscribing to and consuming topic streams

For: developers | Updated: 2026-03-10

๐Ÿ“ Living ICN Configuration Management Guide

Complete configuration reference for ICN nodes

For: operators, developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Configuration Reference

Navigation guide for configuration documentation

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft Identity Backend Configuration

Identity keystore backend configuration guide

For: operators | Updated: 2026-03-10

๐Ÿ“‹ Draft Trust Threshold Configuration

Trust score threshold configuration guide

For: operators | Updated: 2026-03-10

๐Ÿ“ Living SDIS API Guide

Complete API guide for Sovereign Digital Identity System

For: developers | Updated: 2026-03-10

๐Ÿ“‹ Draft SDIS + Steward System Status

Snapshot of SDIS deployment status

For: team | Updated: 2026-03-10

๐Ÿ”’ Canonical Grant Application Artifacts

Navigation for grant application templates and materials

For: team | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Budget Skeleton

Grant budget template

For: team | Updated: 2026-03-10

๐Ÿ”’ Canonical Documentation Templates

Navigation guide for documentation templates

For: contributors | Updated: 2026-03-10

๐Ÿ“‹ Draft Development Journal Template

Template for development session journals

For: developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Vision & Strategy

Navigation guide for vision and strategy documents

For: all | Updated: 2026-03-10

Security

๐Ÿ“ Living Gateway Content Security Policy

CSP configuration for ICN gateway ensuring safe web integration

For: security, developers | Updated: 2026-03-10

๐Ÿ”’ Canonical Security Documentation Index

Navigation and overview of security-related documentation

For: security, architects | Updated: 2026-03-15

๐Ÿ“ Living Secret Management

Policy and design for managing cryptographic secrets and sensitive data

For: security, operators | Updated: 2026-03-10

๐Ÿ“ Living TOFU (Trust-On-First-Use) Security Model

Trust establishment for first-time peer contact without certificates or CAs

For: security, developers | Updated: 2026-03-10

๐Ÿ“‹ Draft Phase 10C Security Analysis

Security analysis and hardening for multi-party contracts

For: security | Updated: 2026-03-10

๐Ÿ“ Living Production Hardening

Hardening measures protecting against DoS, resource exhaustion, and operational failures

For: operators, security | Updated: 2026-03-15

๐Ÿ“ Living ICN Security Roadmap

Security architecture and phased hardening approach

For: security, architects | Updated: 2026-03-15

๐Ÿ“ Living ICN Threat Model

Comprehensive threat model covering attack vectors, adversary capabilities, and mitigations

For: security, architects | Updated: 2026-03-15

Status

๐Ÿ“ Living ICN State (living doc)

Living snapshot of repo layout, decisions, constraints, and current engineering status

For: developers, agents | Updated: 2026-03-18

Strategy

๐Ÿ“‹ Draft Documentation namespace resolution plan

Plans vs planning, ops vs operations; no moves executed here

For: contributors | Updated: 2026-03-26

๐Ÿ“‹ Draft SDIS Complete Build Plan

Detailed SDIS build plan from API to mobile

For: architects | Updated: 2026-03-10

๐Ÿ“‹ Draft SDIS & Steward Completion Roadmap

Roadmap for SDIS and steward system completion

For: architects | Updated: 2026-03-10

๐Ÿ“ Living ADR-001: What ICN Is

Architectural Decision Record defining ICN scope, non-goals, and boundary conditions

For: developers, architects, stakeholders | Updated: 2026-02-28

๐Ÿ“ Living What ICN Is

Canonical definition: problem statement, solution approach, scope and non-goals

For: all | Updated: 2026-03-17

๐Ÿ“ Living ICN Evolution Arc

Long-term vision across phases 0-3, from MVP to mature cooperative ecosystem

For: architects, stakeholders | Updated: 2026-03-08

๐Ÿ“ Living ICN Gap Analysis March 2026

Comprehensive implementation assessment across 10 subsystems with evidence and gaps

For: grant-reviewers, architects, product | Updated: 2026-03-17

๐Ÿ“ Living ICN Pitch

Elevator pitch, one-pagers, and public communication messaging framework

For: stakeholders, public | Updated: 2026-03-10

๐Ÿ“ Living ICN Live Roadmap

Current sprint and quarterly priorities, immediate milestones, and dependencies

For: team, stakeholders | Updated: 2026-03-21

๐Ÿ“ Living ICN Roadmap Strategy

Strategic roadmap phases 0-3 with dependencies, milestones, and long-term vision

For: architects, stakeholders, grant-reviewers | Updated: 2026-03-12

๐Ÿ“ Living ICN Scenarios

Use case narratives and operational scenarios demonstrating ICN in practice

For: product, marketing | Updated: 2026-03-09

๐Ÿ“ Living ICN Sprint March 17

Specific sprint plan and tactical objectives for week of March 17, 2026

For: team | Updated: 2026-03-17

๐Ÿ“ Living ICN Technical Whitepaper

Formal technical specification for grants, regulatory review, and architectural validation

For: grant-reviewers, architects, compliance | Updated: 2026-03-15

๐Ÿ“‹ Draft ICN Compliance Architecture

Regulatory-safe design rationale for grants

For: compliance, grant-reviewers | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Grant Narrative Core

Reusable grant narrative sections

For: team | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Grant One-Pager

One-page ICN summary for grant applications

For: grant-reviewers | Updated: 2026-03-10

๐Ÿ“‹ Draft ICN Milestones

Project timeline through pilot deployment

For: grant-reviewers | Updated: 2026-03-10

๐Ÿ“‹ Draft Pilot Readiness Assessment

Assessment of pilot readiness and gaps

For: team | Updated: 2026-03-10


Summary

Total documents: 246

By status:

  • Canonical: 38
  • Draft: 48
  • Living: 160