A model for collaborative behavior built from raw primitives describing how we think and how we collaborate that builds into a way to talk about how human and artificial intelligence works and how we can all work together effectively.
| File | Purpose |
|---|---|
primitives.md |
The fundamentals, formally — Actor, Role, Node, Edge, Uriam Graph. Everything else is built on this. |
primitives-plain.md |
The same fundamentals, in plain English — why the framework works |
references.md |
External sources the framework draws on |
origin.md |
The framework's history |
SKILL.md |
The operational layer — how to actually run Uriam in a live conversation |
analogy-spiral.md |
Optional: the cycle pictured as a climbing staircase |
analogy-production.md |
Optional: the Repertoire, the Conductor, and the musical-theatre picture |
bin/profile/ runs the primitives against a spread of LLMs — current and legacy Anthropic models, plus local Ollama models — to check whether primitives.md is an unambiguous specification, and how differently models actually understand it.
primitives.md+bin/profile/instructions.md— the test material itselfbin/profile/README.md— how the harness works, and how to run it
There's nothing to install. Point an AI assistant at this repo (or paste in SKILL.md, alongside the other files if it can't read them directly) and ask it to work through Uriam with you.
Uriam requires explicit invocation — say the word to start it, no ambient auto-detection. See SKILL.md for the current invocation phrase.
"I've been thinking about going to Geneva for a holiday. I keep looking at flights and hotels but I haven't booked anything."
Claude will identify which stage of the graph you're in, which Role you're about to meet, and what genuine forward movement looks like.
The full framework — the primitives, the matrix, Momentum, and how it maps onto AI system design — is in primitives-plain.md. The Repertoire and the Conductor are pictured in analogy-production.md.
Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)
Free to use and adapt with attribution. Commercial use requires permission.