Skip to content
@ICL-System

ICL-System

Intent Contract Language — Deterministic intent contracts for AI systems

ICL — Intent Contract Language

crates.io npm PyPI License: MIT

A formal, deterministic, language-agnostic specification language for intent contracts.

What is ICL?

ICL defines a standard way to express intent contracts — machine-verifiable declarations of what a system intends to do. Every contract is deterministic (same input → identical output), verifiable (all properties machine-checkable), and bounded (execution bounded in memory and time).

contract HelloWorld {
  version: "1.0"
  identity {
    name: "hello-world"
  }
  intent {
    action: "greet"
    description: "A simple greeting contract"
  }
}

How is ICL Different from Guardrails?

Guardrails and system prompts are suggestions an LLM can ignore or misinterpret. ICL contracts are mathematically enforced walls — verified before execution, impossible to bypass.

System Prompts Guardrails ICL
What it is Natural language instructions Runtime filters Formal, verified contracts
Enforcement LLM interprets (may ignore) Probabilistic Mathematical proof
Analogy "Please don't" Smoke detector Fireproof wall

Where ICL is used: Trading agents that CANNOT exceed limits · Surgical robots that MUST stop if sensors fail · Drones that CANNOT enter restricted airspace · Code deploy agents that CANNOT ship without passing tests

See the full ICL vs Guardrails — 50+ real-world examples for when (and when not) to use ICL.

Repositories

Repository Description
ICL-Spec The standard — BNF grammar, specification, conformance tests
ICL-Runtime Canonical Rust implementation (native, Python, JS/WASM, Go)
ICL-Docs Documentation website

Install

# Rust
cargo install icl-cli

# Python
pip install icl-runtime

# JavaScript
npm install icl-runtime

Architecture

One Rust codebase, compiled to every target:

ICL Text → Parser → AST → Normalizer → Canonical Form
                           ↓
                        Verifier → Type Check + Invariants + Determinism
                           ↓
                        Executor → Sandboxed Execution

Core Principles

  • Determinism is non-negotiable — same input → identical output, always
  • Spec is authoritative — the specification defines truth, code must match
  • Single codebase — all logic in Rust, compiled to every platform
  • Verifiable — all contract properties are machine-checkable
  • Bounded — all execution bounded in memory and time

License

MIT

Pinned Loading

  1. ICL-Docs ICL-Docs Public

    ICL Documentation - getting started, contract authoring, CLI reference, API docs, and architecture guides

    CSS

  2. ICL-Runtime ICL-Runtime Public

    Canonical Rust implementation of ICL - parser, normalizer, verifier, executor, CLI, and language bindings (Python/JS/Go)

    Rust

  3. ICL-Spec ICL-Spec Public

    ICL Standard - BNF grammar, core specification, conformance test suite, and example contracts

    Clean

Repositories

Showing 4 of 4 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…