About Tell
Why the protocol exists, how it got its name, and where it's going.
The Problem
Every layer of the modern technology stack has a standard. Authentication has OAuth. APIs have OpenAPI. Agent tooling has MCP. Code has version control.
Strategy has nothing.
Strategic intent — what an organisation is betting on, what assumptions underpin those bets, and what evidence says about whether they're working — lives in slide decks, board packs, and the heads of a few senior leaders. It can't be queried. It can't be versioned. It can't be read by the AI agents that increasingly execute on an organisation's behalf.
The result: AI agents operate at machine speed with zero strategic context. They can do things, but they have no way of knowing whether those things align with what the organisation actually cares about.
Tell is the protocol that fills this gap.
Why “Tell”?
In poker, a tell is the involuntary signal that reveals the truth behind the bluff. A twitch, a pause, a pattern in the betting — something that tells you what's really going on beneath the surface.
Every strategy has tells too. Evidence signals buried in data, customer behaviour, market movements, operational metrics — signals that reveal whether your strategic assumptions are actually holding or quietly breaking.
Most organisations can't read the tells because their strategy lives in a deck, not a model. Tell is the protocol that makes those signals readable — by humans and by machines.
“We named it Tell because that's what evidence does — it tells you whether your thesis is holding.”
Protocol vs. Platform
Tell — The Protocol
- Open standard, Apache-2.0 licensed
- Defines the format and semantics
- Community-governed as it matures
- Anyone can implement it
Apophenic — The Platform
- Canonical Level 3 implementation
- Visual canvas, real-time collaboration
- AI-powered strategic intelligence
- Cloud sync and team features
Tell is designed to be useful even without Apophenic. A team could implement a basic Tell model in a spreadsheet. An agent framework could support Tell reads and writes. A consulting firm could structure client engagements using Tell.
Apophenic is where the full Level 3 Platform experience lives — real-time events, version history, scenario modelling, AI-powered intelligence — but the protocol itself is open for anyone to implement.
Roadmap
Conceptual Model
Core entity definitions, initial ontology design.
Expanded Specification
Full entity schemas, conformance levels, MCP integration patterns, evidence weighting algorithm.
JSON Schema + Tooling
Formal JSON Schema for all entities. CLI tool, MCP server, TypeScript libraries. Published as @tell-protocol/* npm packages.
Multi-Portfolio & Cloud Sync
Multiple named portfolios under .tell/, interactive REPL mode, cloud sync (push/pull), portfolio management commands. CLI v0.4.1.
Formal Specification
RFC-style formal spec. Comprehensive test suite. Reference implementation in TypeScript and Python.
Guiding principle: Validate before you publish. Tell is being refined through real deployments before the formal 1.0 specification is released.
Ready to build?
Start with the specification, explore the getting started guide, or install the CLI.