Onboarding

Iris

31 cards ~ 2.5 h Foundational

Foundational walk through the iris project. Read top to bottom if you're new; no prior context assumed.

  1. iris beginner 3 min

    IRIS Ecosystem Overview

    Use when: explaining IRIS to a new teammate; onboarding onto the iris-hq organisation; pitching the project to a non-technical stakeholder

  2. iris beginner 4 min

    Three-Tier Architecture (Core → Choco → MERIDIAN)

    Use when: explaining the deployment model; deciding which tier to integrate with; onboarding a platform engineer

  3. iris intermediate 5 min

    Sprite Data Model & Schema

    Use when: creating or validating a new sprite; understanding the JSON Schema structure; debugging fingerprint mismatches

  4. iris intermediate 5 min

    Council Orchestration Model

    Use when: creating a new council; understanding gate authority rules; designing governance rules for a domain

  5. iris intermediate 5 min

    Chain & ChainStep Schema

    Use when: designing a new chain; debugging chain execution failures; understanding step-to-step data flow

  6. iris intermediate 4 min

    Gate Engine & Veto Mechanics

    Use when: designing gate conditions; debugging unexpected vetoes; understanding fail-open vs fail-closed behaviour

  7. iris advanced 7 min

    Blake3 5-Stage Canonical Fingerprinting (DEC-005)

    Use when: implementing or debugging fingerprint computation; cross-system identity verification; understanding the STRATT-compatible hash pipeline

  8. iris advanced 8 min

    Synchronous Chain Execution Engine (DEC-002)

    Use when: designing chain execution logic; debugging vetoed or failed chains; understanding the synchronous execution model

  9. iris intermediate 5 min

    REST API — Sprite CRUD & Verification

    Use when: integrating with the sprite registry; understanding sprite lifecycle endpoints; implementing a client for iris-service

  10. iris intermediate 5 min

    REST API — Council Creation & Chain Execution

    Use when: creating a council via the API; executing chains programmatically; debugging 409 GATE_VETO responses

  11. iris intermediate 5 min

    MCP Bridge — 4 Tools (Tier 2)

    Use when: integrating IRIS with Claude or other MCP clients; understanding MCP tool delegation; deploying the MCP server to Cloudflare Workers

  12. iris advanced 7 min

    gRPC MERIDIAN Adapter (Tier 3)

    Use when: bridging IRIS sprites into MERIDIAN; understanding cross-system federation; implementing gRPC clients for the adapter

  13. iris advanced 6 min

    NFT-Style Capability Token System

    Use when: designing authorization for cross-system sprite access; understanding token lifecycle and revocation; implementing capability-based security

  14. iris advanced 6 min

    Cross-System Fingerprint Verification

    Use when: verifying sprite identity across IRIS and MERIDIAN; debugging fingerprint mismatches in federation; understanding the 5-stage verification pipeline

  15. iris beginner 4 min

    Governance Model & Sprite Role Hierarchy

    Use when: assigning roles to new sprites; designing council governance structures; understanding decision-making authority

  16. iris intermediate 6 min

    5 Locked Architectural Decisions (DEC-001 to DEC-005)

    Use when: understanding why IRIS is built the way it is; arguing for or against a design change; onboarding architects onto the project

  17. iris intermediate 6 min

    Docker Compose & Observability Stack

    Use when: deploying iris-service locally or in production; understanding the full infrastructure stack; debugging observability issues

  18. iris intermediate 5 min

    OpenTelemetry Instrumentation & Metrics

    Use when: adding observability to iris-service code; understanding what metrics are collected; configuring trace sampling

  19. iris beginner 5 min

    Python SDK & CLI

    Use when: writing Python scripts that interact with IRIS; using the CLI to validate sprites; computing fingerprints from the command line

  20. iris beginner 4 min

    TypeScript SDK & MCP Client

    Use when: building web apps that interact with IRIS; understanding the zero-dependency SDK; comparing Python and TypeScript client patterns

  21. iris intermediate 5 min

    JSON Schema 2020-12 & Validation Pipeline

    Use when: validating sprite/council/chain definitions; understanding schema structure and $defs; extending the IRIS schema

  22. iris intermediate 4 min

    In-Memory Registry Architecture

    Use when: understanding how iris-service stores data; debugging registry behaviour; planning the PostgreSQL migration

  23. iris intermediate 5 min

    PostgreSQL Database Schema (ORM Models)

    Use when: understanding the planned database schema; migrating from in-memory registries to PostgreSQL; writing raw SQL or SQLAlchemy queries

  24. iris intermediate 4 min

    Namespace URI System (iris:// ↔ strat://)

    Use when: understanding cross-system identity mapping; implementing namespace resolution; debugging mapping conflicts

  25. iris advanced 8 min

    End-to-End Chain Execution Request Flow

    Use when: tracing a chain execution through the entire system; debugging performance bottlenecks; understanding the full request lifecycle

  26. iris beginner 4 min

    CI/CD Pipeline & Schema Propagation

    Use when: understanding the build process; making cross-repo changes; setting up local development

  27. iris beginner 3 min

    The Agent Council Platform

    Use when: writing the IRIS homepage hero or one-line description; explaining IRIS to someone who already builds with LLMs

  28. iris beginner 3 min

    Who IRIS Is For

    Use when: qualifying a lead as the right or wrong fit for IRIS; deciding which channel or community to launch into

  29. iris beginner 2 min

    The Pitch in One Screen

    Use when: writing the IRIS homepage above-the-fold; drafting a one-paragraph description for a directory listing

  30. iris beginner 4 min

    Shipping the Foundation

    Use when: explaining what IRIS has shipped versus what is still ahead; writing a launch post or changelog summary

  31. iris beginner 4 min

    Why Not Just a Framework

    Use when: responding to 'couldn't you do this in LangChain or CrewAI?'; comparing IRIS against generic agent frameworks