This folder hosts the Level 2 documentation: one HTML file per architectural component. It is populated gradually. A rule of life: a component is not implemented before its HTML exists and has been approved.
neuron → executor,
synapse → mnest,
proteome → mnestome. The whole previous
microdesign must be re-read and rewritten before being used as a reference
for implementation. The files remain here as traceability of the design path.
executor.html
(replaces neuron.html, approved on 24 Apr 2026),
mnest.html (replaces synapse.html,
under approval), mnestome.html
(new, under approval). On 25 Apr 2026 two more canonical docs were added:
synt.html (replaces
synthesizer.html) and telos.html
v1.1 (rewrite), bringing the canonical set to five. All bilingual (IT · EN)
and all approved after the end-to-end «invoices in
mail» simulation (25/4/2026). The other components will follow in the
order shown below.
| Component | What it covers | Languages | Status |
|---|---|---|---|
executor.html |
Anatomy of an executable capability: manifest, Ed25519 signature, sandbox profile (with operational «called wrong» example), lifecycle, synthesis (cascade in §7.1), remote executors. Replaces neuron.html. |
IT · EN | approved 24 Apr |
mnest.html |
The trace of co-activation between two executors: anatomy, lifecycle, decay, persistence, proto-mnest. Replaces synapse.html. |
IT · EN | approved 25 Apr |
mnestome.html |
The emergent graph of all mnests: SQLite data schema, atomic operations, ager, snapshots. New concept (in IT: mnestoma). | IT · EN | approved 25 Apr |
synt.html |
How the executor pool is born and matures: reactive cascade (compose, generate) and introspective cascade (merge, generalise, specialise). Non-retreat telos, extended R score. Replaces synthesizer.html. |
IT · EN | approved 25 Apr |
telos.html |
User's ultimate ends, alignment function, bother budget with scheduler-driven quotas, non-retreat telos (t.coltivazione_strumenti) and stop clause. Rewrite of telos v1.0. |
IT · EN | approved 25 Apr |
Following Perspectives & Judgement v1, the microdesign writing order changed: three cross-cutting docs go before the four classical ones, because without them the four classics would be pattern-violators.
| # | Cross-cutting doc | Which blocking critiques it solves |
|---|---|---|
| 1 | agent_runtime.html |
reasoning loop, tool-call validation, ExecutionTrace, prompt structure |
| 2 | approval_ux.html |
approval batching, reading pause, revoke, tutor mode |
| 3 | eval.html |
15-20 YAML scenarios + replay harness + success/cost report |
Each linked document opens the Italian microdesign page. The English description below summarises what the component covers.
| Component | What it covers | Phase | Status |
|---|---|---|---|
types.html ✓ IT |
Canonical index of cross-component types. Introduces PlannedAction and TrustScore. Versioning discipline and drift detection. |
1 (cross-cutting) | obsolete |
agent_runtime.html ✓ IT |
Reasoning loop (ReAct), prompt structure, tool-call validation, ExecutionTrace, provider failover via supra. | 1 (first) | obsolete |
approval_ux.html ✓ IT |
CLI/Telegram approval flows, batching, reading pause, revoke, tutor mode. | 1 (first) | obsolete |
eval.html ✓ IT |
YAML scenarios, replay harness, success/latency/cost metrics, CI gate. | 1 (first) | obsolete |
gateway.html ✓ IT |
FastAPI, sessions, webhooks, cron, auth. | 1 | obsolete |
channel.html ✓ IT |
Channel Protocol, CLI, then Telegram. |
1 / 3 | obsolete |
tool.html ✓ IT |
Tool Protocol, base set (fs, shell, web_fetch, supra adapters). |
1 | obsolete |
sandbox.html ✓ IT |
Bubblewrap profiles, systemd hardening, optional Docker. | 1 | obsolete |
policy.html ✓ IT |
Autonomy levels, approval gating, rate/cost limits, forbidden paths, cost tiering. | 2 | obsolete |
workspace.html ✓ IT |
Markdown files IDENTITY / USER / MEMORY / AGENTS / SOUL. | 2 | obsolete |
observability.html ✓ IT |
JSON logging, append-only audit log, metrics, health. | 2 | obsolete |
pairing.html ✓ IT |
DM pairing: code flow, signature, revocation. | 3 | obsolete |
memory.html ✓ IT |
Memory Protocol, session persistence + long-term facts. |
4 | obsolete |
config.html ✓ IT |
pydantic-settings schema, overrides, secrets. | 1 (cross-cutting) | obsolete |
| "Neurons and Memory" extension (see doc v1) | |||
rl_offline.html ✓ IT |
Self-evolution without training. 3 experiments: trace-scoring / synth-reward / neuron self-play. Introduces TrustStore. |
5 / 7 (cross-cutting) | obsolete |
neuron.html ✓ IT |
Structure of a neuron: manifest, body, birth test, signature, journal. | 6 | obsolete |
synthesizer.html ✓ IT |
Synthesis pipeline: failure → spec → draft → static analysis → test → human approval. | 5 / 6 | obsolete |
synapse.html ✓ IT |
Neuron graph: declared/observed synapses, counters, decay, pruning. | 7 | obsolete |
constitution.html ✓ IT |
The 4 Laws, SOUL.md, modification rite, prompt-level enforcement. | 2 | obsolete |
| "Extended Perspectives" extension (see doc v1) | |||
telos.html v1.0 |
(historical row) TELOS.md, alignment function, bother budget. Promoted to v1.1 on 25/4/2026: see the v1.1 canonical table above. | 4-5 | v1.1 canonical |
vaglio.html ✓ IT |
Constitutional Guard (binary, deterministic) + teleological Judge (gradient, independent LLM). Resolves self-critic bias; pairs with telos. Vaglio = "the sieve". |
4-5 | obsolete |
coerenza_v1.html ✓ IT |
Coherence review across all 21 components. 6 blocking fixes + 7 medium fixes applied 22 April 2026. | meta | obsolete |
Every microdesign HTML file follows the same template as Architecture — Introduction:
id;
planned — component recognised, document not yet written.
drafting — document in draft, do not use as reference.
approved — final document. Implementation may begin.
built — code exists in src/myclaw/<component>/.
obsolete — document superseded by later decisions (renames from the Dialogue on executors, Architecture v1.1). Kept as traceability, to be rewritten before implementation.
The microdesign only makes sense against the foundation documents. If you are reading a component in this folder, keep these open too: