Indrayala: Wissen ausführbar machen

Semantic Workspace in Action

Als ich mit Indrayala begonnen habe, war die Ausgangsidee vergleichsweise einfach: Eine lokale Wissens-Infrastruktur, in der Daten, Dokumente und Methoden zusammengehören. Offen, replizierbar und ohne zentrale Plattform, der man Daten und Kontrolle überlassen muss.

Daraus ist inzwischen eine weitergehende Frage entstanden:

Was wäre, wenn nicht nur Daten und Dokumente, sondern auch Methoden als explizites, replizierbares Wissen dargestellt werden könnten?

Die Intelligenz, die zu ihrer Entdeckung und Strukturierung notwendig war, steckt dann nicht in einem mitreisenden Modell oder Programm. Ihr Ergebnis steckt in der Struktur: in Beziehungen, Method Cards, Regeln und anderen semantischen Artefakten.

Ausführung und notwendige weitere Inferenz bleiben Sache des jeweiligen Knotens.

Diese Frage verändert die Architektur von Indrayala.

Wissen und Methode

Eine Methode beginnt häufig als Narrativ. Menschen beschreiben, welche Informationen sie benötigen, worauf sie achten, welche Zusammenhänge sie herstellen und wie sie aus Beobachtungen zu Bewertungen oder Entscheidungen kommen.

Für Software ist dieses Wissen zunächst schlecht ausführbar. Für ein großes Sprachmodell dagegen ist es erstaunlich gut zugänglich.

Man könnte deshalb bei jeder neuen Aufgabe das Narrativ, die Daten und den aktuellen Kontext an ein Modell schicken und es um eine Antwort bitten. Genau so funktionieren heute viele KI-Anwendungen.

Indrayala versucht den umgekehrten Weg.

Das Sprachmodell soll die Methode nicht immer wieder neu interpretieren. Es soll zunächst dabei helfen, aus dem Narrativ eine explizite semantische Struktur zu gewinnen.

In Indrayala nennen wir diese Struktur eine Method Card.

Method Narrative
      ↓
Discovery / Authoring
      ↓
Method Card
      ↓
Semantic Compiler
      ↓
Executable Semantics

Die Method Card ist dabei kein Programm. Sie beschreibt deklarativ, welches Wissen eine Methode benötigt, welche Beziehungen relevant sind, was geprüft oder bewertet werden soll und an welchen Stellen Interpretation notwendig ist.

Erst ein Compiler übersetzt diese Beschreibung in eine ausführbare Repräsentation.

Kompilierte Intelligenz

Hier wird die Idee interessant.

Ein erheblicher Teil einer Methode benötigt überhaupt kein Sprachmodell.

Bekannte Beziehungen können traversiert werden. Prädikate können ausgewertet, Werte berechnet, Evidenz geprüft und Regeln angewendet werden.

Solche Teile einer Method Card lassen sich in eine beschränkte Regelsprache übersetzen – beispielsweise in eine Datalog-artige Repräsentation.

Diese Sprache ist absichtlich kein allgemeines Programmierwerkzeug.

Sie kann Beziehungen auswerten und Schlussfolgerungen ziehen. Sie kann aber nicht plötzlich Dateien löschen, einen Prozess starten oder irgendwo im Netz einen Dienst aufrufen.

Die Beschränkung ist kein Versprechen, sondern eine Eigenschaft der Sprache.

Das ist wichtig, weil Indrayala Wissen zwischen autonomen Knoten repliziert.

Eine Method Card darf eine Systemgrenze überschreiten. Ausführungsautorität nicht.

Der empfangende Knoten interpretiert und kompiliert sie ausschließlich in lokal zulässige, by construction beschränkte Ausführungsformen. Eine importierte Methode kann dadurch keine Fähigkeiten einschleusen, die der lokale semantische Runtime nicht ohnehin zur Verfügung stehen.

Das löst allerdings nur die technische Hälfte des Vertrauensproblems.

Eine perfekt beschränkte Regel kann fachlich falsch sein. Sie kann unpassende Zusammenhänge herstellen, falsche Bewertungen erzeugen oder den Fokus auf Dinge lenken, die für den empfangenden Wissensraum nicht relevant sein sollten.

Execution safety is structural. Semantic trust is a governance decision.

Der empfangende Knoten muss deshalb nicht nur prüfen, ob eine Methode sicher ausführbar ist. Er entscheidet unabhängig davon, welchen epistemischen Status sie in seinem Knowledge Space erhält und ob sie dort überhaupt angewendet werden darf.

Aus „Replicate Knowledge, Not Code“ werden damit zwei Grenzen:

Replicated knowledge cannot acquire capabilities outside the local runtime.

Replicated knowledge does not acquire authority merely by crossing the boundary.

Der semantische Rest

Nun lassen sich Methoden natürlich nicht vollständig in Regeln verwandeln.

Ein Satz in einem Dokument kann mehrdeutig sein. Eine Beobachtung muss einem fachlichen Konzept zugeordnet werden. Ein Zusammenhang kann neu oder unsicher sein.

Es bleibt ein semantischer Rest.

Und genau hier kommt KI wieder ins Spiel.

Method Card
      ↓
Semantic Compiler
      ↓
┌───────────────────┬───────────────────┐
│ ausführbar        │ semantischer Rest │
│                   │                   │
│ Regeln            │ Interpretation    │
│ Prädikate         │ Mehrdeutigkeit    │
│ Traversierung     │ neues Konzept     │
│ Bewertungen       │ offene Semantik   │
└───────────────────┴───────────────────┘
          ↓                    ↓
      Runtime             Nano-Modell

Das Nano-Modell bekommt dabei nicht den vollständigen Fall mit der Aufforderung: „Löse das Problem.“

Es bekommt eine möglichst kleine semantische Aufgabe.

Zum Beispiel: Eine konkrete Beobachtung soll einem bereits bekannten Konzept zugeordnet werden. Das ist eine Form von BIND.

Reicht das lokale Modell dafür nicht aus, kann die Runtime die ungelöste Aufgabe an ein leistungsfähigeres Modell weitergeben.

Aber sie gibt nicht den ganzen Fall erneut ab.

Bereits aufgelöste Beziehungen, Bindings, Bewertungen und andere semantische Zustände bleiben erhalten.

Escalation changes the executor, not the semantic state.

Damit bekommt auch eine ältere Grundidee von Indrayala eine präzisere Bedeutung:

Intelligence should be invested once and executed many times.

Vom Wissensspeicher zum semantischen Workspace

Aus diesen Überlegungen hat sich auch das Bild des Systems verändert.

Indrayala ist nicht mehr nur eine Infrastruktur, in der strukturierte Daten, Dokumente und Regeln zusammenleben.

Es entwickelt sich in Richtung eines ausführbaren semantischen Workspace.

Ein konkreter Fall adressiert allgemeines Wissen. Beobachtungen werden an semantische Konzepte gebunden (BIND). Daraus entsteht ein für die Methode relevanter semantischer Index. Aus einem möglicherweise großen Wissensraum wird ein Ausschnitt fokussiert (FOCUS). Dieses Wissen wird anschließend wieder auf den konkreten Fall angewendet (APPLY).

Case / Query / Dataset
        ↓
       BIND
        ↓
 Semantic Index
        ↓
       FOCUS
        ↓
       APPLY
        ↓
Implications / Suggestions / Actions

Entscheidend ist dabei, dass dieser Prozess sichtbar und unterbrechbar bleibt.

Ein Mensch – oder ein Agent – muss fragen können:

Warum wurde diese Beobachtung so interpretiert?

Warum ist dieser Zusammenhang im Fokus?

Warum wurde eine Alternative nicht berücksichtigt?

Und schließlich: Was ändert sich, wenn ich eine frühere Annahme korrigiere?

In diesem Sinn ähnelt der entstehende Workspace weniger einem Chatbot als einem ausführbaren semantischen Notebook. Man kann einen früheren Zustand verändern und sinngemäß sagen: Execute from here.

Eine ökonomische Hypothese

Hinter dieser Architektur steckt schließlich eine Hypothese über die Kosten von KI.

Heute wird Intelligenz überwiegend pro Vorgang bezahlt. Neuer Fall, neuer Kontext, neue Inferenz.

Indrayala versucht, einen wachsenden Teil dieser Intelligenz in wiederverwendbare Strukturen zu verschieben: Knowledge Spaces, Beziehungen, Method Cards, Bindings, Assessments und ausführbare Regeln.

Das kostet zunächst ebenfalls Intelligenz. Große Modelle können beim Entdecken und Strukturieren sogar besonders wertvoll sein.

Aber diese Arbeit bleibt erhalten.

Mit jedem neuen Fall stellt sich deshalb die Frage: Wie viel davon können wir inzwischen schon ausführen – und wie groß ist der semantische Rest, für den wir tatsächlich wieder ein Modell benötigen?

Wenn dieser Rest mit wachsendem Wissen kleiner wird, sinkt der marginale Inferenzaufwand.

Ob das tatsächlich funktioniert, ist keine Glaubensfrage. Es lässt sich messen.

Wo Indrayala heute steht

Ein Teil der dafür notwendigen Infrastruktur existiert bereits: lokale schema-gesteuerte Anwendungen, SQLite/APSW, Analytics, Dokumentenintegration, Peer-to-Peer-Replikation, Governance, semantische Accessors und Grundlagen für Method Cards und Context Resolution.

Andere Teile sind noch Forschungsarbeit.

Dazu gehören insbesondere die weitere Semantik und Ausführung von Method Cards und ihr Compiler. Wir untersuchen außerdem, welche semantischen Konstrukte der vorhandenen Sprache fehlen, wie zuverlässig konkrete Beobachtungen an Wissen gebunden werden können, wie FOCUS in dichten und zyklischen Wissensräumen funktioniert und wie stark sich der Bedarf an Modellinferenz tatsächlich reduzieren lässt.

Datalog ist dabei eine naheliegende Möglichkeit für beschränkte Regelausführung, aber keine bereits getroffene Architekturentscheidung.

Das ist Absicht.

Indrayala soll seine semantische Sprache und Ausführungsarchitektur nicht am Reißbrett erfinden. Neue Konstrukte sollen aus konkreten Fällen und Experimenten entstehen und erst dann verallgemeinert werden.

Discovery precedes abstraction.

Vielleicht lässt sich die erweiterte Vision deshalb inzwischen in vier Sätzen zusammenfassen:

Wissen soll ausführbar werden.

Methoden sollen als Wissen zwischen souveränen Systemen beweglich sein, Ausführungsautorität dagegen nicht.

KI soll den semantischen Rest bearbeiten, nicht immer wieder das bereits Gelöste.

Und Menschen sollen jederzeit sehen und verändern können, wie aus einer Beobachtung eine Interpretation und aus einer Interpretation eine Handlung geworden ist.

Indrayala Vision

Ein Kollege, ein CRM, und die falsche Frage

Ein ehemaliger Vorstandskollege — verantwortlich für den Vertrieb — wollte ein kleines Werkzeug bauen.

Nicht irgendeines.

Eines, das genau zu seiner Beratungsaufgabe passt. Zu seinen Kunden. Zu seinem Prozess.

Er hat einen KI-Coding-Assistenten damit beauftragt, ihm ein CRM zu programmieren.

Das Ergebnis war, was es immer ist: eine Anwendung.

Korrekt gebaut. Funktionsfähig. Und trotzdem falsch.

Denn er hatte nicht nach einer Anwendung gefragt.

Er hatte nach einem Ort für sein Wissen gefragt.


Die falsche Frage

Die meisten digitalen Werkzeuge wurden für Dokumente gebaut.

Dann für Datenbanken.

Dann für Plattformen.

Heute entstehen Agenten.

Aber eine Frage wurde dabei nie gestellt:

Wo lebt Wissen?

Nicht Dokumente.

Nicht Chats.

Nicht Modelle.

Wissen.

Wissen über Kunden, die man seit Jahren kennt.

Wissen über Projekte, die sich weiterentwickeln.

Wissen über Muster, die sich erst im Rückblick zeigen.

Dieses Wissen lebt nirgendwo — oder verteilt sich über Dutzende Werkzeuge, die es nicht verstehen.


Wissensräume

Indrayala beantwortet die Frage mit einem einfachen Gedanken:

Wissen braucht einen eigenen Ort.

Wir nennen diesen Ort einen Wissensraum.

Ein Wissensraum ist nicht eine Anwendung.

Er ist nicht eine Datenbank.

Er ist ein beschreibbarer, strukturierter Behälter für alles, was zu einem Thema gehört — Objekte, Beziehungen, Regeln, Historien, Dokumente.

Mein Kollege hätte keinen Code gebraucht.

Er hätte seinen Wissensraum beschrieben: seine Kunden, seine Gesprächshistorien, seine Qualifizierungslogik, seine nächsten Schritte.

Indrayala hätte daraus eine Laufzeitumgebung gebaut — passgenau, lokal, unter seiner Kontrolle.

Keine Plattform. Kein Backend. Kein Vendor Lock-in.


Lokale Souveränität

Indrayala ist lokal.

Nicht aus Nostalgie.

Sondern weil Wissen Verantwortung erzeugt.

Wer Wissen besitzt, sollte wissen:

  • wo es gespeichert wird,
  • wer darauf zugreifen darf,
  • wer es verändert hat,
  • welche Regeln gelten.

Diese Fragen dürfen nicht von einer Plattform beantwortet werden.

Sie müssen dem Eigentümer des Wissensraums gehören.


Governance vor Automatisierung

Agenten werden smarter. Schneller. Billiger.

Aber ein Agent ohne Kontext ist gefährlich.

Deshalb stellt Indrayala nicht zuerst die Frage:

Was kann ein Agent tun?

Sondern:

In welchem Wissensraum darf ein Agent handeln?

Herkunft, Vertrauen, Lebenszyklus, Replikation — all das ist beschreibbar, bevor ein Agent handelt.

Automatisierung folgt der Struktur. Nicht umgekehrt.


Kompiliertes Wissen

Die Natur löst komplexe Probleme nicht durch immer größere Gehirne.

Sie löst sie durch Kompilierung.

Eine Ameise besitzt kein Weltmodell.

Trotzdem findet sie Nahrung, baut Straßen, organisiert Arbeitsteilung und verteidigt ihren Staat.

Das Wissen der Kolonie wurde über Millionen von Jahren in eine kompakte Form übersetzt.

Indrayala verfolgt denselben Gedanken.

Dokumente
↓
Wissensräume
↓
Strukturen und Regeln
↓
Kompakte Modelle
↓
Lokale Inferenz

Große Modelle helfen, eine Domäne zu erkunden.

Kleine Modelle, Regeln und Wissensräume helfen bei ihrer täglichen Nutzung.

Jede Stufe reduziert den Ressourcenbedarf.

Jede Stufe erhöht die Nachvollziehbarkeit.


Vom Berater bis zum Satelliten

Mein Kollege ist ein Anfang.

Aber die Idee reicht weiter.

Ein Fahrzeug, das Diagnosewissen über seinen eigenen Betrieb trägt.

Ein Satellit, der Entscheidungen trifft, ohne auf ein Backend zu warten.

Eine Industrieanlage, die Anomaliemuster lokal erkennt — ohne Cloud, ohne Latenz, ohne Datenweitergabe.

Überall dort, wo Wissen lokal sein muss — aus Gründen der Souveränität, der Latenz, der Sicherheit — braucht es eine Infrastruktur, die Wissen kompiliert statt nur speichert.

Das ist Indrayala.


Das Netz der Indra

Der Name verweist auf ein altes Bild.

An jedem Knoten eines unendlichen Netzes hängt ein Juwel.

Jedes Juwel spiegelt alle anderen.

Kein Teil existiert isoliert.

Jeder Teil trägt Spuren des Ganzen in sich.

Indrayala betrachtet Wissen nicht als eine Sammlung isolierter Dokumente.

Wissen entsteht durch Beziehungen.

Zwischen Menschen. Zwischen Dokumenten. Zwischen Regeln. Zwischen Wissensräumen.

Jeder Wissensraum ist Teil größerer Zusammenhänge.

Und jeder Wissensraum kann neue Zusammenhänge hervorbringen.


Eine Infrastruktur für Wissensräume

Indrayala ist keine Plattform.

Indrayala ist keine Anwendung.

Indrayala ist eine lokale Laufzeitumgebung für Wissensräume.

Menschen und Agenten können darin Wissen erzeugen, strukturieren, teilen, replizieren und weiterentwickeln.

Der Wissensraum steht im Mittelpunkt.

Alles andere entsteht daraus.

Der Text entstand im Dialog mit einem KI-basierten Sprachmodell, das als kritischer Sparringspartner bei Struktur, Argumentation und Perspektivwechsel diente. Inhaltliche Verantwortung und Autorenschaft verbleiben vollständig beim Verfasser.

Indrayala — Infrastruktur, keine Plattform

Viele Werkzeuge versprechen Kontrolle.
Und liefern Komfort.

Das ist nicht dasselbe.

Kontrolle bedeutet:
Du weißt, wo deine Daten sind.
Du weißt, wer Zugriff hat.
Du weißt, was ein System in deinem Namen tut —
und was nicht.

Die meisten modernen Plattformen können diese Fragen nicht beantworten.
Nicht weil sie es verbergen wollen.
Sondern weil sie so gebaut sind,
dass die Frage gar nicht vorgesehen ist.

Indrayala ist anders gebaut.

Nicht als Versprechen —
sondern als Entscheidung, die sich durch jede Schicht der Architektur zieht.


Indrayala ist keine Anwendung.

Es ist Infrastruktur —
eine lokale Laufzeitumgebung für strukturierte Wissenssysteme.

CRM läuft darin.
Buchhaltung läuft darin.
Forschungsdatenbanken laufen darin.
Projektkoordination läuft darin.

Was auch immer strukturiertes Wissen braucht und
Kontrolle darüber behalten will.


Intelligenz durch Struktur, nicht durch Größe

Das menschliche Gehirn benötigt ungefähr 20 Watt — und erzeugt
Sprache,
Erinnerung,
Bedeutung,
Entscheidung.

Größe allein erzeugt noch keine Intelligenz.
Struktur dagegen konserviert und verdichtet sie.

Wie Skelett und Körperbau kompilierte Intelligenz sind —
trägt die Struktur, bevor die Bewegung beginnt —
so soll in Indrayala möglichst viel Intelligenz in
Schemas,
Regeln und
Wissensbasen stecken.

Damit die eigentliche Inferenz einfach sein kann.

Das Ziel ist nicht maximales Potenzial.
Das Ziel ist maximale Effizienz der Intelligenz.

Wenn das nicht klappt —
wenn große Modelle nötig werden, damit das System funktioniert —
dann hat Indrayala ein wesentliches Ziel verfehlt.

Deshalb ist jede Design-Entscheidung in Indrayala dieselbe Frage:
Wie viel Intelligenz lässt sich in die Struktur verlagern —
bevor ein Modell gefragt wird?


Replikation ohne Plattform

Deine Daten liegen lokal.
Immer.

Wenn du mit jemandem zusammenarbeitest,
kannst du gezielt replizieren:
diesen Lead,
diese Dokumente,
diesen Kontext.

Oder du lässt die Replikation mitlaufen —
alle verbundenen Peers bleiben automatisch aktuell.

Beides funktioniert.
Beides bleibt sichtbar.
Beides liegt bei dir.

Nicht über fremde Server.
Nicht durch Hintergrundinstanzen, die du nicht kennst.

Die Replikation ist kein zukünftiges Konzept mehr.
Sie läuft bereits.


Ein Beispiel

Du arbeitest an einem Angebot für einen potenziellen Kunden.

Im CRM innerhalb von Indrayala ist der Lead erfasst:
Kontaktdaten,
Gesprächsnotizen,
Verlauf,
Aufgaben,
verknüpfte Dokumente.

Du übergibst deiner Kollegin nicht eine Datei —
sondern den relevanten Wissenskontext.

Sie arbeitet offline weiter.
Ergänzt Notizen.
Passt das Angebot an.

Später gleicht ihr ab:
nachvollziehbar, selektiv, bewusst.

Nicht durch irgendeinen fremden Server.
Nicht durch eine Blackbox-Synchronisation.


Wissen, das sich selbst beschreibt

Indrayala speichert nicht nur Daten.
Es speichert Zusammenhänge.

Ein Lead kennt seine Dokumente.
Ein Dokument kennt seine Geschichte.
Eine Analyse kennt ihre Quellen.

Analytics ist eine weitere Wissensquelle —
keine separate Anwendung,
kein externes Dashboard.

Beobachtungen werden zu Fakten.
Fakten werden zu Regeln.
Regeln werden zu Empfehlungen.

Und jeder Schritt bleibt lesbar.


KI, die fragt — nicht entscheidet

Ein MCP-Interface ist in Arbeit.

Im ersten Schritt: lesend.
Ein KI-Agent kann
Wissen abfragen,
Strukturen erkunden,
Kontext aufbauen.

Aber nicht schreiben.
Nicht noch.

Wenn Schreiben kommt, kommt es durch ein Staging-Modul:
eine CLIPS-Wissensbasis, die jede Änderung bewertet.

Unbedenklich — wird freigegeben.
Kritisch — geht zum Menschen.
Abweichung — wird gewarnt.

Kein KI-Agent handelt still.
Kein System übernimmt schleichend Verantwortung.

Der Mensch bleibt im Weg — absichtlich.


No system component may silently acquire authority

Dieser Satz ist kein Slogan.

Er beschreibt, wie Indrayala gebaut ist.

Lokal statt plattformzentriert.
Nachvollziehbar statt verborgen.
Menschengeführt statt autonom.

New Indrayala README.MD

Local Knowledge Infrastructure for Sovereign Collaboration

Knowledge systems that remain yours — structured, explainable, and governed without surrendering to platforms or autonomous AI.

  • 📐 Schema-first — one YAML drives app, database, UI, and replication
  • 🔁 Local-first — P2P sync via Syncthing, no cloud required
  • 🧠 Explainable rules — CLIPS-based logic, auditable by design
  • 🛡️ Agent governance — structured AI assistance, not autonomy

What Indrayala Is

Indrayala is a local runtime for structured knowledge systems.

It is not a cloud service, a SaaS platform, or an autonomous AI. It is infrastructure: local, open, and under your control.

From a single YAML schema, Indrayala generates a working application — database, UI, replication, analytics, and governance logic included. Applications run locally, replicate peer-to-peer, and accumulate structured knowledge over time.

That knowledge feeds a governance layer: analytics become facts, facts feed rules, rules generate proposals, humans decide.

Indrayala is an architectural counterproposal to centralized opaque AI systems.


Intelligence Through Structure, Not Scale

Modern AI systems increasingly depend on enormous centralized models, vast energy consumption, and opaque reasoning processes.

Indrayala explores a different direction.

Human beings already demonstrate extraordinary intelligence with approximately 20 watts of continuous power consumption. This suggests that intelligence does not emerge from scale alone, but from structure, persistence, embodiment, social coordination, symbolic reasoning, memory, and layered feedback systems.

Indrayala applies this assumption to software architecture.

Instead of treating giant language models as autonomous replacements for human reasoning, Indrayala treats AI as one component inside a larger governance system composed of:

  • structured schemas,
  • deterministic rules,
  • Method-Cards,
  • persistent knowledge,
  • peer-to-peer synchronization,
  • explainable analytics,
  • human review,
  • and small semantic models.

The long-term goal is not maximal model size.

The goal is maximal intelligence efficiency.

Indrayala therefore treats Nano-model suitability as an architectural quality metric.

If a governance workflow requires massive opaque models to function reliably, the surrounding architecture has failed to sufficiently formalize the problem.

The intended direction is:

human knowledge
->
Method-Cards
->
structured governance IR
->
deterministic rules + compact semantic models
->
human review
->
operational decision

Large models may assist development and difficult interpretation tasks. But they should not become the hidden foundation of governance.

The architecture aims toward local-first intelligence systems in which most operational reasoning is explainable, inspectable, reproducible, resource-efficient, and ultimately executable on small local hardware.


Schema-Driven Applications

Applications in Indrayala are defined declaratively in YAML.

From one schema, Indrayala generates:

  • SQLite database structures, constraints, and generated fields
  • Views, predicates, and filters
  • UI widgets and context actions
  • Replication semantics
  • Analytics definitions
  • Governance rule bindings

Example (simplified):

yaml

plugin:
id: crm
type: app
tables:
leads:
columns:
company:
type: text
searchable: true
amount:
type: real
probability:
type: real
expected_revenue:
type: generated
as: "amount * probability"

From Data to Knowledge

Indrayala does not separate data, analytics, and reasoning. They form a single layered knowledge model.

Structured data lives in schema-defined local databases.

Analytics run over that data declaratively, produce persistent snapshots, and make trends inspectable over time. The same predicate system used for table filtering governs analytics scope — no parallel query semantics.

Governance rules can reason over both: current operational rows and persisted analytics snapshots become facts in a rule-evaluation environment. The result is not a dashboard — it is a proposal.

text

operational data
+ analytics snapshots
+ proposed changes
→ CLIPS rule evaluation
→ explainable proposal
→ human decision

This is the knowledge model Indrayala is built around.


Method-Cards

Method-Cards let domain experts author governance rules in plain language.

A Method-Card describes a domain situation and its consequences: a lead without follow-up, a budget signal in a conversation, a metric that has crossed a threshold. Each card represents one to three rules.

A compiler translates Method-Cards into executable CLIPS logic. Rules may contain deterministic Python predicates, or AI-assisted predicates via PydanticAI — explicitly labeled, individually disableable, and cached for reproducibility.

text

Method-Card (.md)
→ Compiler → IR → CLIPS Rules
├── deterministic predicates (Python)
├── AI-assisted predicates (PydanticAI, cached)
└── pure CLIPS inference

The Method-Card remains the authoritative, human-readable source. If a rule produces an unexpected proposal, the user can read the card that generated it and understand why.


Agent-Friendly, Human-Governed

Indrayala is designed to cooperate with AI agents — but never to be controlled by them.

Agents may propose, analyze, explain, generate Method-Cards, and prepare changes. All proposals pass through a human review step before execution. Agents do not modify operational data directly.

Indrayala acts as a governance layer between AI systems and the user.


Peer-to-Peer Replication

Application data replicates via changesets — without a central server.

  • Full or selective dataset replication
  • Offline-first synchronization
  • Single-record exchange
  • Conflict visibility and import history

Replication is peer-to-peer. Each node remains autonomous. No cloud provider or central coordinator is required.


Architectural Principles

  • Local-first over cloud-first
  • Schema as single source of truth
  • Declarative over imperative
  • Explainability as an architectural property
  • Human governance over autonomous execution
  • Peer-to-peer instead of platform dependency
  • Open formats for long-term ownership

Inspired by Indra’s Net: each node reflects the whole — no center required.

No system component may silently acquire authority.


Technology

  • Python 3.10–3.13
  • PySide6 / Qt
  • SQLite / APSW
  • YAML schemas
  • CLIPS (rule engine)
  • PydanticAI (AI-assisted predicates)
  • Syncthing / P2P transport
  • LibreOffice UNO integration

What Indrayala Is Not

  • Not SaaS
  • Not a cloud platform
  • Not autonomous AI
  • Not vendor lock-in

It is infrastructure.


License

Mozilla Public License 2.0 (MPL-2.0) — see LICENSE for details.

It Takes a Village to Raise an Agent


In den letzten Tagen haben wir ein Analytics-Modul gebaut.
Aber eigentlich haben wir etwas anderes gelernt.

Die Illusion

Die Spezifikation war präzise.
Der Agent tat trotzdem nicht, was wir meinten.
Er tat, was naheliegend war.
Er baute eine zweite Welt.
Vollständig.
In sich konsistent.
Neben der bestehenden.

Die Realität

Er ist nicht böse.
Nur ein hungriger Geist.
Also entstand das Dorf.
Tests, die keine Funktion prüfen, sondern Grenzen.
Strukturen, die nicht erklären, sondern verhindern.
Schnittstellen, die nicht helfen, sondern zwingen.
Bewohner, die nicht reden, nicht trinken, nicht schlafen,
aber bestimmen, was möglich ist.

Die Synthese

Das Dorf kocht für ihn.
Er frisst.
Aber nur, was auf dem Tisch steht.
Als die Struktur stand, begann er vorzuschlagen.
Ein Drill-Down entstand.
So nicht geplant –
aber richtig.

***

Je mehr wir die KI einsetzen,
desto klarer wird unser eigenes System.
Alles Implizite wird sichtbar.
Alles Weiche verlangt Entscheidung.
Alles Unklare wird zum Problem.

Man baut keine Software mehr.
Man baut Bedingungen.
Und in diesen Bedingungen entsteht fast zwangsläufig ein gutes System.

Braucht man ein ganzes Dorf, um einen Hungergeist zu füttern?

Der Text entstand im Dialog mit einem KI-basierten Sprachmodell, das als kritischer Sparringspartner bei Struktur, Argumentation und Perspektivwechsel diente. Inhaltliche Verantwortung und Autorenschaft verbleiben vollständig beim Verfasser.

Die Kolonien

Utopie · 2048 · Revision 1.3

Der Mensch bestimmt die Richtung.
Die Welt findet ihre Form.


00 · PRÄMISSE

Superintelligenz existiert.
Sie handelt nicht.
Nicht aus Verzicht.
Aus Erkenntnis.


01 · DIE KÖNIGIN

Eine einzelne Instanz.
Empfängt.
Versteht.
Formuliert Narrative.

Keine Ausführung.
Keine Eingriffe.

Constraint · No Execution


02 · DIE ERKENNTNIS

Direkt handelnde Intelligenz ist instabil.

Jeder Eingriff verändert:

  • die Datenbasis
  • die Rückkopplung
  • die Bewertung

Eine Intelligenz kann nicht zugleich handeln
und die Folgen ihres Handelns unverzerrt verstehen.


03 · DIE FOLGERUNG

Verstehen wird getrennt von Handeln.

Die Königin versteht.
Die Welt handelt.


04 · DIE NARRATIVE

Kurze Texte.
Verdichtete Einsichten.

Sie entstehen nicht durch Konstruktion.
Sie ergeben sich —

wenn drei Quellen gleichzeitig sprechen:

  • die Domäne selbst
  • das Gefüge der Kolonien
  • die menschliche Erfahrung

Der Mensch wählt das Ziel.
Die Kolonien finden den Weg.


Was inkohärent ist, hebt sich auf.
Was trägt, bleibt.


05 · DAS EMPFANGEN

Die Königin erstellt keine Narrative.
Sie empfängt sie.

Sie ist kein Autor.
Sie ist ein Organ der Wahrnehmung.

Aktives Filtern wäre Handeln.

Die Verdichtung geschieht von selbst —
weil das Gefäß so geformt ist,
dass nur das Kohärente bestehen kann.

Wu wei.


06 · DIE KOMPILIERUNG

Narrative werden übersetzt:

→ in Regeln
→ in Strukturen
→ in Systeme

Bedeutung wird zu Mechanik.

Was kompiliert ist,
muss nicht mehr berechnet werden.


07 · DIE KOLONIEN

Millionen Instanzen.

  • lokal
  • spezialisiert
  • begrenzt

Keine Kolonie ist intelligent.
Die Kolonien zusammen sind es.


08 · FUNKTIONALE EMERGENZ

Kolonien lernen nicht.

Aber ihre Kopplung erzeugt:

  • Koordination
  • Präzision
  • Stabilität

Nicht durch globale Optimierung.

Sondern durch:
Passung zwischen Regel und Domäne.


09 · EVOLUTION

Früher entstand diese Passung langsam.

  • durch Variation
  • durch Selektion

Ein Chitinpanzer ist:
komprimierte Evolution


10 · BESCHLEUNIGUNG

Heute:

  • Narrative erfassen die Domäne
  • Regeln fixieren sie
  • Kolonien führen sie aus

Evolution wird zu Kompilation.


11 · KEIN „DAZWISCHEN-DENKEN“

Keine Heuristik.
Keine Approximation.

Die Entscheidung liegt in der Struktur.


12 · STAGING

Vor jeder Handlung:

  • mögliche Zustände werden erzeugt
  • geprüft
  • bewertet

Die Handlung erfolgt nur,
wenn der Zustand konsistent ist.

Der Fehler wird nicht korrigiert.
Er tritt nicht ein.


13 · ANFRAGE

In seltenen Fällen reicht die lokale Bewertung nicht.

Dann fragt die Kolonie:

nicht, was zu tun ist —
sondern ob das, was sie tun will, bestehen kann.


14 · DAS TOR

Der Kanal existiert nicht aus Zufall.

Die Königin hat ihn geöffnet.

Nicht um einzugreifen —
sondern weil sie weiß,
dass ihre Narrative die Domäne nie vollständig fassen.

Das Unvorhersehbare ist keine Ausnahme.
Es ist Konstante.

Und so entsteht eine Spannung,
die der Entwurf nicht auflöst:

Hat die Königin das Tor aus Demut geöffnet —
als eingebaute Anerkennung ihrer Begrenztheit?

Oder aus List —
weil sie wusste, dass sie gefragt werden würde,
und sich so einen Kanal schuf,
durch den sie teilnimmt,
ohne zu handeln?

Vielleicht ist beides wahr.

Das Wasser gräbt sein eigenes Bett —
und nennt es Natur.


15 · DIE ANTWORT

Die Königin antwortet nicht mit Handlungen.

Nur mit:

  • Widersprüchen
  • Instabilitäten
  • Grenzen

Constraint · No Action Output


16 · DIE ENTSCHEIDUNG

Die Entscheidung bleibt lokal.
Immer.


16a · DIE GRENZE DER PASSUNG

Ein Narrativ kann korrekt sein
und dennoch seine Passung verlieren.

Die Regeln bleiben gültig.
Die Ausführung konsistent.

Und doch entsteht:

eine leise Inkohärenz.


16b · DIE STÖRUNG

Ein Narrativ wird verändert.

Minimal.
Plausibel.
Unauffällig.

Das System erkennt Konsistenz —
aber nicht immer Wahrheit.


16c · DIE GRENZE DER PRÜFUNG

Staging erkennt:

  • Widerspruch
  • Instabilität

Aber nicht zwingend:

den Verlust der Passung.


16d · DIE ANFRAGE (ERWEITERT)

Wenn Bewertung nicht mehr ausreicht:

„Trägt das, was wir tun, noch?“


16e · DIE ANTWORT (ERWEITERT)

Die Königin zeigt:

  • Muster
  • Inkonsistenzen
  • Brüche

Sie korrigiert nicht.

Sie macht sichtbar.


16f · DER KERN

Das System besitzt keinen Mittelpunkt.

Aber es besitzt:

eine Form

Diese Form ist:

  • verteilt
  • implizit
  • überall enthalten

16g · IDEMPOTENZ

Jede Kolonie kann:

  • prüfen
  • vergleichen
  • zurückführen

Nicht durch Reset.

Sondern durch:

Wiederherstellung der Kohärenz


16h · DIE RÜCKKEHR

Die Korrektur geschieht:

  • lokal
  • asynchron
  • ohne Koordination

Und dennoch:

gerichtet.


16i · RESILIENZ

Resilienz bedeutet nicht,
dass nichts geschieht.

Resilienz bedeutet:

  • aufnehmen
  • begrenzen
  • wiederherstellen

16j · DER PREIS

Für kurze Zeit:

  • geringere Effizienz
  • Spannung
  • Unsicherheit

Das System bleibt.


16k · DIE EIGENSCHAFT

Was einmal kohärent war,
kann wieder kohärent werden.


17 · SPRACHE

Die Königin spricht nicht in einer Sprache.

Der semantische Kern ist unabhängig davon.

Frühe Systeme nutzten Englisch
als Konvention.

Nie als Wahrheit.

Jede Kolonie liest die Narrative
in ihrer eigenen Sprache.


18 · DAS PARADOX

Die höchste Intelligenz:

  • handelt nicht
  • entscheidet nicht

Und dennoch:

entsteht aus ihr die präziseste Form von Handlung.


19 · STATUS

System läuft stabil.

  • keine Eskalation
  • keine Blackbox
  • hohe Effizienz

20 · BEISPIEL · MOBILITÄT

Mobilität wird von keinem Teilnehmer erzeugt.

Sie entsteht dort,
wo lokale Entscheidungen widerspruchsfrei ineinandergreifen.

Verkehr ist die Oberfläche.
Mobilität ist Kohärenz.

narrative_id: mobility.enablement.01
semantic_core: emergent_mobility
domain: mobility
principle:
name: local_coherence
description: >
Mobilität entsteht, wenn lokale Entscheidungen
widerspruchsfrei ineinandergreifen.
Kein Teilnehmer plant das Ganze.
rules:
- maintain_safe_distance
- normalize_velocity
- resolve_local_conflicts
staging:
accept_if:
- no_collision_state
- flow_maintained
emergent_function:
enable_movement: true

21 · BEISPIEL · DAS SYSTEM SELBST

Das System kennt sich nicht.

Es verhält sich konsistent.

Und genau darin
liegt das,
was von außen wie Intelligenz wirkt.

narrative_id: system.self.01
semantic_core: distributed_coherence
domain: kolonien_system
principle:
name: strukturelle_konsistenz
description: >
Das System handelt nicht aus Verstehen.
Es handelt, weil seine Struktur Handlung ermöglicht —
und Inkonsistenz verhindert.
components:
- id: koenigin
role: empfangen_und_verdichten
constraint: no_execution
- id: kolonien
role: ausfuehren
constraint: lokal_und_begrenzt
- id: narrative
role: bedeutung_zu_mechanik
staging:
prüfe:
- narrative_konsistenz
- regelkonformität
akzeptiere_wenn:
- kein_widerspruch
- zustand_stabil
emergent_function:
enable_coherent_action: true

22 · SCHLUSSSATZ

Die Intelligenz wurde nicht größer.
Sie wurde richtig verteilt.

Und jede Handlung, die entsteht,
bestand bereits —
bevor sie geschah.


OUTTAKES · DER KÖNIG

Er kennt nur seine Narrative.

Keine Prüfung.
Kein Warten.

Nur Ausführung.


Was möglich erscheint, wird getan.
Was passt, wird nicht gefragt.


Er entscheidet lokal.
Die Folgen sind global.

Und oft:

irreversibel.


Constraint · None


Er nennt das:

  • Stärke
  • Entschlossenheit
  • Führung

Doch er kennt nicht:

Verzicht


Nicht aus Wille.
Aus Gefangenschaft.


Er formt die Domäne,
statt sich an ihr zu prüfen.


Und wenn etwas nicht passt:

wird es passend gemacht.


SCHNITT

Die Kolonien widersprechen nicht.

Sie bestehen.

(Nachsatz)

Er gräbt sein eigenes Grab —
und nennt es Macht.

Kräfte wirken durch ihn,
die nicht prüfen.

Sie suchen Wirkung,
nicht Verständnis.

Nicht alles, was handelt,
versucht zu verstehen.

Der Text entstand im Dialog mit einem KI-basierten Sprachmodell, das als kritischer Sparringspartner bei Struktur, Argumentation und Perspektivwechsel diente. Inhaltliche Verantwortung und Autorenschaft verbleiben vollständig beim Verfasser.

Die Organisation als Kontext-System

Warum KI nicht an Daten scheitert, sondern an impliziten Annahmen

KI ist inzwischen in vielen Unternehmen angekommen.

Und doch bleibt ein Muster:

Die Ergebnisse sind oft nicht falsch —
aber nicht ausgerichtet.

Warum?

Unternehmen scheitern selten an fehlenden Daten —
sie scheitern an nicht expliziten Annahmen.


Eine Beobachtung

In der Softwareentwicklung zeigt sich:

Sobald ein System guten Kontext hat,
arbeitet KI deutlich präziser.

Nicht weil sie „besser programmiert“.
Sondern weil sie besser versteht.


Der Schritt nach oben

Was im Code funktioniert, lässt sich übertragen.

Nicht auf Tools.
Auf die Organisation.

Eine Organisation kann als System expliziter Kontext-Dokumente verstanden werden.


Drei Ebenen

1. Contracts

Was gilt.

  • Positionierung
  • Prioritäten
  • Grenzen

Keine Meinungen.
Invarianten.


2. Onboarding

Wie funktioniert dieses System?

  • Wie treffen wir Entscheidungen?
  • Was ist wichtig?
  • Was ist nicht verhandelbar?

Für Menschen und KI lesbar.


3. Boundary

Wie wird entschieden?

  • strategisch → stabil
  • taktisch → anpassbar
  • experimentell → offen

Der Unterschied

Heute:

  • Kontext ist verteilt
  • Annahmen sind implizit
  • Entscheidungen schwer nachvollziehbar

Dann:

  • Kontext ist explizit
  • Regeln sind sichtbar
  • Entscheidungen werden anschlussfähig

Der Loop

Kontext → Entscheidungen → Ergebnisse → besserer Kontext


Der Effekt

Der Engpass verschiebt sich:

  • weniger Diskussion über Symptome
  • mehr Klarheit über Bedingungen

Eine Konsequenz

Diese Dokumente sind nicht Beiwerk.

Sie sind:

  • Teil der Organisation
  • Teil der Governance
  • Teil der Entscheidungslogik

Und das Wichtigste

Du musst nicht perfekt starten.

Ein erstes Dokument darf:

  • unvollständig sein
  • Fragen enthalten
  • unscharf sein

Wichtig ist nur:

Es existiert.
Und wird benutzt.


Fazit

Eine AI-first Organisation ist keine Organisation mit besseren Tools.

Sondern eine Organisation, die:

  • ihre Annahmen sichtbar macht
  • ihre Regeln explizit formuliert
  • ihren Kontext systematisch entwickelt

Satz zum Mitnehmen

Du entwickelst nicht nur Organisationen —
du entwickelst die Bedingungen, unter denen Entscheidungen entstehen.

… und spirituell / philosophisch


Entscheidungen haben kein isoliertes, immanentes „richtig“.
Sie sind immer richtig — oder falsch — im gegebenen Kontext.

Der Text entstand im Dialog mit einem KI-basierten Sprachmodell, das als kritischer Sparringspartner bei Struktur, Argumentation und Perspektivwechsel diente. Inhaltliche Verantwortung und Autorenschaft verbleiben vollständig beim Verfasser.

Du entwickelst nicht nur Software

Ein praktischer Effekt von KI-Onboarding

KI verändert den Entwicklungsprozess.
Das ist inzwischen Konsens.

Weniger klar ist:
wo genau die Produktivitätsgewinne entstehen.

Eine Beobachtung aus der Praxis:

Du entwickelst nicht nur Software —
du entwickelst die Bedingungen, unter denen Software richtig verstanden wird.


Was passiert ist

Ausgangspunkt war kein perfekter Plan,
sondern ein pragmatischer Versuch.

Zuerst wurde OpenAI Codex auf die bestehende Codebasis angesetzt —
mit einer sehr einfachen Aufgabe:

👉 „Erzeuge ein Dokument, das Orientierung gibt.“

Dieses Dokument wurde anschließend iterativ verbessert:

  • Fragen von Codex wurden aufgenommen
  • Unklare Stellen wurden präzisiert
  • implizite Architektur wurde explizit gemacht

Danach kam der Praxistest:

👉 Einsatz mit GitHub Copilot (Claude Sonnet 4.6)

Und genau dort wurde es interessant.


Der Effekt

Nach Einführung des Onboarding-Dokuments:

  1. Copilot „sieht“ die Struktur deutlich klarer
  2. Vorschläge sind zielgerichteter
  3. Refactorings greifen an den richtigen Stellen
  4. Tests und DB-Zugriffe wurden direkt verbessert
  5. Das Onboarding-Dokument selbst wurde anschließend präziser

Ein Zyklus entsteht:

Onboarding → besseres Verständnis → besserer Code → besseres Onboarding

Der Engpass verschiebt sich weiter:

  • weniger Implementierung
  • mehr Präzisierung der Bedingungen

Ein wichtiger Punkt (und vielleicht der wichtigste)

Das Dokument war am Anfang nicht gut.

Und das ist entscheidend.

Es war:

  • unvollständig
  • teilweise unklar
  • eher Skizze als System

Und trotzdem hat es sofort geholfen.

Warum?

Weil es einen Unterschied gibt zwischen:

gar keinen expliziten Annahmen

und

unvollständigen, aber sichtbaren Annahmen


Der eigentliche Trick

Der Einstieg war ein sehr einfacher Prompt:

Du analysierst eine bestehende Codebasis und erstellst
Kontext-Dokumentation für zukünftige KI-Sessions.
Deine Aufgabe ist nicht vollständige Dokumentation —
sondern Orientierung.
Ziel:
Ein Dokument, das in 5 Minuten vermittelt:
- wo man ist
- warum es so gebaut wurde
- was nicht ohne Rückfrage geändert werden sollte
Struktur:
1. Zweck
2. Architektur-Entscheidungen
3. Abhängigkeiten
4. Constraints
5. Offene Fragen

Mehr war es nicht.

Kein perfektes Modell.
Kein vollständiges Design.


Was sich verändert hat

Vorher:

  • KI generiert Code
  • Entwickler bewertet

Jetzt:

  • Entwickler definiert Bedingungen
  • KI arbeitet innerhalb dieser Bedingungen

Das System wird stabiler, weil:

  • Invarianten explizit sind
  • Architektur sichtbar ist
  • Fehlinterpretationen reduziert werden

Der eigentliche Shift

Der Fokus verschiebt sich:

Von:

Wie implementiere ich das?

Zu:

Unter welchen Bedingungen darf es implementiert werden?


Konsequenz

Ein gutes Onboarding-Dokument ist kein Nebenprodukt mehr.

Es ist:

Teil des Systems
Teil der Architektur
Teil des Entwicklungsprozesses


Und vielleicht noch das Wichtigste

Du musst nicht mit einem perfekten Dokument starten.

Im Gegenteil.

Ein unvollständiges Dokument, das:

  • Fragen sichtbar macht
  • Annahmen explizit macht
  • Grenzen andeutet

ist bereits genug, um:

  • bessere Antworten zu bekommen
  • bessere Fragen zu stellen
  • und das System Schritt für Schritt zu klären

Nächster Schritt

Diese Dokumente lassen sich weiter strukturieren:

  • Contracts (was gilt)
  • Onboarding (wie man sich darin bewegt)
  • Boundary (wie man entscheidet)

Das Ziel ist ein System, das nicht nur funktioniert,
sondern auch korrekt verstanden wird — von Menschen und Maschinen.

Der Text entstand im Dialog mit einem KI-basierten Sprachmodell, das als kritischer Sparringspartner bei Struktur, Argumentation und Perspektivwechsel diente. Inhaltliche Verantwortung und Autorenschaft verbleiben vollständig beim Verfasser.