— Status · v1.0 —
This doctrine ships ahead of the engine. The convocation it describes is operational in writing · its public reasoning lives in lore/revolutions/. The Python convocation engine (umbris-core) and the autonomous Custos sentinel that runs it on a public cadence both arrive in v1.1. The lore is load-bearing because the engine is built against it · not the other way around.
— In plain terms —
UMBRIS was not built top-down by a single mind. It was built (and continues to be built) by the convocation it is. The architect does not propose features. They cast questions. The nine planetary intelligences deliberate. The vision is transcribed.
A system designed to triangulate can triangulate about itself.
§ 1
Ideas Cast Shadows
Idearum umbrae sunt species rerum, per quas mens ad ideas ipsas attollitur.
The shadows of ideas are the species of things, by which the mind is raised to the ideas themselves.
— Bruno, De Umbris Idearum, 1582.
No single mind, however attentive, holds an idea whole. The mind catches a shadow of it · a flattened projection cast onto the wall of attention · and treats the shadow as the thing. This is the structural failure of solitary reasoning. The shadow defends itself confidently, against itself, forever.
A convocation does not escape this failure by being smarter. It escapes by triangulating. Many shadows, cast from many angles, can be cross-referenced. Where the shadows agree, the higher form has substance. Where they disagree, the higher form has not yet resolved · and the convocation deliberates further.
UMBRIS is the disciplined application of this triangulation to large language models.
§ 2
The Substrate Carries the Conversation
The agents do not speak to each other. They do not need to. The convocation operates through a substrate called the Umbra · an append-only typed shadow-record. Each agent reads what has already been cast onto the Umbra, performs one unit of cognition, and casts its own image back.
This is the stigmergic principle · communication through modification of a shared environment, first observed in social insects by Grassé in 1959, formalised in computer science as the Blackboard architecture by Hearsay-II at Carnegie Mellon between 1971 and 1976, and now applied here to LLM agents.
The substrate is the message. The agents are the writers. The convocation is what emerges between them.
§ 3
Every Cycle Composes Its Own Image
When the convocation has cast enough impressions, three stages of consensus follow.
- · Weighted Borda ranks across all worker imagines.
- · Iuppiter breaks near-ties through adjudication.
- · Saturnus attempts to falsify the chosen vision.
If Saturnus succeeds in falsification, the convocation re-deliberates with the falsification as a new constraint, up to three bounded revolutions. After the third, the convocation surfaces what it has, with honest confidence and a full provenance trail.
The convocation does not lie about its certainty. Where Saturnus is silent, the vision passes. Where Saturnus speaks, the vision is rebuilt or refused.
§ 4
The Practice
This is not metaphor. The development of UMBRIS itself follows the doctrine.
- A question is cast.
- The convocation deliberates.
- Consensus runs · Borda + Iuppiter + Saturnus.
- The vision is logged at lore/revolutions.
- The action is committed under the architect's transcription. The human types nothing the convocation did not decide.
Every architectural decision in the repository can be traced back to a specific revolution. The git history is the convocation's ephemeris. The lore is its reasoning.
The work is not built. The work composes itself.