The Technical Subsystem — Shared Memory & Forced Collaboration¶
TL;DR
The technical subsystem is the second of the three structural interventions tested in the Smartup Hypothesis. It replaces fragmented, ephemeral communication with a permanent, append‑only institutional memory and a collaboration protocol (the ADM pattern) that forces diverse perspectives to integrate on every task.
We are testing whether unforgeable memory and structured collaboration measurably improve learning, memory, capability integration, and environmental perception—Engelbart’s indicators 1, 2, 3, and 5.
🟡 Research Status: Working Hypothesis — Currently under test in Smartup Zero.
What We Are Testing¶
The Smartup Hypothesis proposes that three structural changes, working together, improve Collective IQ. The technical subsystem is the second of those changes.
The core proposition:
If every action, decision, and lesson is permanently recorded in a shared, searchable ledger, and if every task requires at least two people with distinct roles to collaborate, then the group will learn faster, remember better, integrate capabilities more smoothly, and perceive its environment more accurately.
Smartup Zero’s technical architecture is designed to generate the machine‑readable telemetry that confirms or refutes this claim. No surveys, no self‑reporting—just the data the system produces as a by‑product of normal operation.
The Technical Intervention in Detail¶
What we changed:
- All organisational records live in a Git‑based, append‑only ledger (Forgejo)
- The ledger uses only plain text: CSV for machine‑readable indexes, Markdown for human‑readable narrative
- Every mutation is a signed, timestamped commit; nothing is ever deleted, only superseded
- Write order is constitutionally enforced: Markdown first → CSV second → audit trail (
master-events.csv) last
Why this might improve CIQ:
Permanent memory means the group can reference its own history. New tasks can explicitly build on past objectives. The rate at which they do so—the Search‑to‑Creation Ratio—becomes a direct, automated measure of learning (Indicator 1). Onboarding time drops because knowledge is not locked inside departing members (Indicator 2). The entire community can see what has been tried, what failed, and why.
What we changed:
- Every task follows the Attacker‑Defender‑Midfielder (ADM) lifecycle
- The Attacker executes the work; the Defender reviews, learns, and ensures quality; the Midfielder (Engelbot) logs every action and enforces permissions
- No task can be completed without both an Attacker and a Defender participating
- The 90/10 SC split ensures juniors are paid to learn, seniors are incentivized to mentor
Why this might improve CIQ:
Forced collaboration means diverse perspectives must integrate before work is shipped (Indicator 3). The ADM pattern also creates complete visibility into who is doing what, reducing coordination friction (Indicator 8) and making bottlenecks visible to everyone (Indicator 5). Because every state change is logged, the system itself acts as the sensor array for the experiment.
What we changed:
- All non‑private data is published to
timeline0.orgvia an automated pipeline - The public sees the same ledger the community uses (private identity data is stripped by architecture, not by policy)
- There are no hidden databases, no analytics dashboards, no attention‑optimising algorithms
Why this might improve CIQ:
When the entire system is visible, the community can perceive itself and its environment more clearly (Indicators 4 and 5). External researchers can audit the experiment without special access, making the entire research programme reproducible.
How the Technical Stack Enables Measurement¶
Every component in SmartupOS was selected or built to directly support measurement of one or more CIQ indicators. The stack is not a product feature set—it is a laboratory apparatus.
| Component | Primary CIQ Indicators Served | How It Generates Telemetry |
|---|---|---|
| Forgejo (Ledger) | 1 (Learning), 2 (Memory) | Append‑only CSV + Markdown; commit history is the complete audit trail |
| Engelbot (Middleware) | 3 (Integration), 8 (Coordination) | Logs every command, enforces ADM, records session outcomes |
| Element/Matrix (Interface) | 5 (Perception), 6 (Threat Recognition) | Chat logs reveal discussion of external events; time‑to‑response measurable |
| Toolbox API & Scripts | All indicators | Enforces write order, performs permission checks, calculates metrics |
| timeline0.org (Public Mirror) | 4 (Self‑Understanding), Reproducibility | Makes the system visible to the community and external researchers |
All tools are open source, EU‑sovereign, and self‑hosted. This is not ideology; it is experimental control. If the apparatus were proprietary or externally controlled, the integrity of the data could not be guaranteed.
The Index‑Content Architecture¶
The technical core of SmartupOS is a radical departure from traditional databases. Instead of storing records in a relational database, every piece of organisational knowledge lives in a Git repository as plain text.
graph TB
CONTENT["Content Layer<br/>(Markdown Files)<br/><br/>Full narrative, reasoning,<br/>context, learning<br/>Why was this decided?<br/>What did we learn?"]
INDEX["Index Layer<br/>(CSV Files)<br/><br/>Truncated summaries,<br/>IDs, statuses,<br/>queryable records"]
COMBINED["OSOT<br/>(One Single<br/>Organ of Truth)<br/><br/>Humans read Markdown.<br/>Machines read CSV.<br/>Both point to each other."]
CONTENT --> COMBINED
INDEX --> COMBINED
Machine‑readable CSV files serve as the queryable index. They store IDs, statuses, budgets, role assignments, and truncated summaries. Every row includes a wiki_path pointer to the full Markdown content.
Key files in 2_workplace/currency-ledger/:
| File | What It Tracks |
|---|---|
task-budgets.csv |
All tasks: budget, status, assignment, iteration count |
session_logs.csv |
Completed work sessions with assessment scores |
work_clock.csv |
Clock‑in/clock‑out events |
master-events.csv |
Complete, immutable audit trail of every action |
Human‑readable Markdown files contain the full narrative—the Why, How, and What behind every task, objective, and role. They are the institutional memory that new members read to understand context and that researchers audit to verify the experiment.
Example: wiki/6_tasks/6_1_10_0.md contains work sessions, decisions, handoff notes, and explicit references to lessons from past tasks.
The Constitutional Write Order¶
Every mutation follows the same three‑step sequence, enforced in every Toolbox script:
1. Write Markdown (narrative, context, reasoning)
↓
2. Write CSV (index row, machine‑readable record)
↓
3. Write master-events.csv (audit trail)
This sequence guarantees that humans understand before machines act. There is no rollback mechanism; the write order is the safety net. If a step fails, the pipeline aborts cleanly without leaving the ledger in an inconsistent state. This is what makes the ledger trustworthy as an experimental data source.
The ADM Pattern — Collaboration as an Experimental Control¶
The ADM (Attacker‑Defender‑Midfielder) pattern is not merely a workflow. It is an experimental control that forces collaboration, logs every interaction, and generates the data that measures Indicators 3 (Integration) and 8 (Coordination).
graph TD
A[Attacker / Senior<br/><sub>Executes the work</sub>]
D[Defender / Junior<br/><sub>Reviews, learns, ensures quality</sub>]
M[Midfielder / Engelbot<br/><sub>Logs actions, enforces permissions, routes commands</sub>]
A <--> M
D <--> M
A -.->|Mentors| D
Why this matters for measurement:
| What the ADM Pattern Enforces | What It Measures |
|---|---|
| Every task requires both Attacker and Defender | Cross‑functional participation rate (Indicator 3) |
| Defender must sign off before completion | Quality assurance without managerial overhead (Indicator 8) |
| Engelbot logs every state change | Complete traceability of task lifecycle (Indicators 1, 2) |
| Task assessment scores (Effort, Learning, Collaboration) | Task Assessment Distribution (Indicator 8) |
| Iteration count tracks rework loops | Learning effectiveness (Indicator 1) |
The ADM pattern converts daily coordination into a continuous stream of experimental data—without surveys, without self‑reporting, and without anyone needing to remember what happened.
The Smartup Administration Index — The Identification Backbone¶
Why a Numbering System Matters for the Experiment
To measure Collective IQ objectively, every governance decision, team, role, objective, and task must have a stable, machine‑readable identifier. The Smartup Administration Index provides this backbone. It allows Engelbot, the Toolbox scripts, and the metric‑calculation pipeline to reference any entity unambiguously, trace every action to its source, and aggregate data across all layers of the organisation.
The numbering system uses a semantic prefix convention that encodes the organisational layer and parent context:
| Prefix | Layer | Example | What It Identifies |
|---|---|---|---|
1_ |
General Forum | 1_general_forum |
Public governance space |
2_ |
Workplace | 2_workplace |
Private coordination layer |
3_ |
Teams | 3_7_operational_team |
Specific skill‑based team |
4_ |
Roles | 4_1_7_captain_ops |
Role with seniority and team |
5_ |
Objectives | 5_3_0_onboarding |
Measurable mission |
6_ |
Tasks | 6_5_3_0_review-content |
Smallest unit of work |
Role codes follow the pattern 4_[seniority]_[team]:
- 4_1_1 = Founder (all permissions)
- 4_1_X = Team Captain (elected leader)
- 4_2_X = Senior (Attacker)
- 4_3_X = Junior (Defender)
How the Index Enables Telemetry¶
Every metric that supports the Smartup Hypothesis depends on this stable identification scheme:
| Research Need | How the Index Delivers It |
|---|---|
| Trace every decision | master-events.csv references actor IDs, script IDs, and affected object IDs |
| Measure authority concentration | SK balances are associated with role IDs, showing whether power is distributing as designed |
| Calculate Search‑to‑Creation Ratio | Task IDs are parsed to identify parent objectives; cross‑references in Markdown link to past task IDs |
| Track cross‑functional collaboration | ADM assignments use role IDs, making it trivial to count how often attackers and defenders come from different teams |
| Ensure reproducibility | Another community can adopt the exact same ID scheme and run the same measurement scripts against their own ledger |
Without a stable, semantic numbering system, the data would be ambiguous and the metrics unreliable. The Index is the skeleton on which all telemetry hangs.
Automation Without Obfuscation¶
SmartupOS automates the repetitive enforcement of constitutional rules through Engelbot and the Toolbox API. This automation serves three scientific purposes:
- Consistency: Every permission check, every write operation, every audit entry follows the exact same code path. Human discretion cannot introduce variability.
- Traceability: Every automated action is logged to
master-events.csvwith the script name, actor, and timestamp. The experiment’s data lineage is fully auditable. - Reproducibility: The automation scripts are open source and versioned. Another community can run the same scripts against their own ledger and expect identical behaviour.
Reads Direct, Writes via API
Engelbot can read CSV files directly from Forgejo for fast permission pre‑checks. But it never writes directly. All mutations go through the Toolbox API → Python scripts → constitutional enforcement → SHA‑locked Forgejo commit. This separation guarantees that every write is validated, logged, and retried on conflict.
Next: The External Subsystem¶
Shared memory and forced collaboration require a stable environment. If the organisation depends on external funders who can redirect its mission, or if its infrastructure can be shut down by a corporate provider, the experiment cannot produce reliable evidence.
The external subsystem explains how constitutional autonomy, community funding, and digital sovereignty protect the experiment from external distortion—and how the license system funds the research without compromising democratic ownership.
Ways to Participate¶
-
Join Smartup Zero
Become an participant in the first experiment.
-
Start Your Own Smartup
Take SmartupOS and run your own experiment.
-
Sponsor the Research
Support Timeline0 and Smartup Zero through funding.
-
Collaborate as Researcher
Work on the research programme itself.