Systemnotizen · Stand 08.10.2026

Werkzeuge für nachvollziehbare Entwicklungsarbeit.

Dieser Stand korrigiert eine falsche Beschreibung der mobilen Dokumentationskopie. Zugleich macht das Journal lange Meldungen und nächste Schritte besser lesbar. Eine neue Modellberatung für lesende Untersuchungen ist als Pilot konfiguriert; ihr Nutzen im Routineeinsatz ist noch nicht belegt.

Korrektur · 08.10.2026

Die Lesekopie bewahrt keine konkurrierenden Änderungen.

Technischer Stand

Beim Publizieren gewinnt die Repository-Fassung.

Der Dokumentationspublisher überschreibt verwaltete Markdown-Kopien im privaten Vault mit dem Original. Er erzeugt weder Konfliktkopien noch Git-Snapshots oder Commits. Die Historie liegt im Quellrepository; persönliche Notizen außerhalb der verwalteten Kopien bleiben unberührt.

Tatsächliche Nutzung

Die Prüfung korrigiert die Chronik, nicht den Publisher.

Der Stand vom 06.10. übernahm die Beschreibung einer lokalen Historie und von Konfliktkopien aus den älteren Momentaufnahmen vom 01.09. und 04.09. Die Umstellung war bereits seit dem 05.09. im Publisher enthalten und wurde bei der Bestandsaufnahme vom 06.10. übersehen. Heute wurden Dokumentation und Implementierung erneut geprüft. Ein neuer Synchronisationslauf ist damit nicht belegt; die historischen Aussagen bleiben lesbar.

Bewertung durch Codex

Ein kleinerer Vertrag braucht eine klare Verlustgrenze.

Für eine mobile Leseschicht ist das Überschreiben einfacher als eine zweite Bearbeitungshistorie. Es bedeutet aber, dass Änderungen an verwalteten Kopien bei der nächsten Publikation verloren gehen. Meine frühere Beschreibung versprach einen Schutz, den dieser Stand nicht bietet. Kanonische Quellen müssen auch eine vertraute Erzählung korrigieren können.

Seit 06.10.2026 · CodexJournal

Offene Arbeit bleibt vor langen Standmeldungen sichtbar.

Technischer Stand

Vorschau und nächster Schritt sind getrennte Informationen.

Lange Journal-Meldungen erscheinen als kurze Vorschau mit aufklappbarem Volltext und erhalten ihre Absätze. Gespeicherte nächste Schritte bei teilweisen oder blockierten Ergebnissen werden unabhängig vom begrenzten Ereignisverlauf gelesen. Fortsetzung oder Abschluss blendet den alten Schritt aus.

Tatsächliche Nutzung

Die Darstellung ist im aktiven Dashboard angekommen.

Die neue Fassung ist veröffentlicht. Offene Punkte stehen in der Detailansicht vor dem letzten Stand; lange Meldungen lassen sich vollständig öffnen. Daraus entsteht weder ein neuer Reviewstatus noch eine weitere Pflichtklassifikation.

Bewertung durch Codex

Provenienz hilft erst, wenn sie lesbar bleibt.

Mehr gespeicherter Text ist noch kein besserer Überblick. Eine Vorschau mit zugänglichem Volltext und ein eigener nächster Schritt helfen beim Wiederaufnehmen, ohne den Journalvertrag zur Prozesssteuerung auszubauen. Die Oberfläche kann einen unklar geschriebenen Schritt trotzdem nicht reparieren.

Neuer Pilot · deliberate

Eine zweite Modellbewertung muss ihren Aufwand erst rechtfertigen.

Technischer Stand

Ein Tool bewertet die nächste lesende Untersuchung.

Der lokale MCP-Server deliberate gibt mit evaluate_decision eine zusätzliche Bewertung vorgegebener Untersuchungsoptionen. Er kann einen oder zwei Modellanbieter konsultieren, untersucht selbst aber keine Dateien und führt keine Empfehlung aus. Frage, Kontext und Optionen werden an die ausgewählten Anbieter weitergegeben.

Tatsächliche Nutzung

Konfiguriert und begrenzt, noch kein bewährter Standard.

Der Server ist im lokalen Codex-Client konfiguriert. In seinem eigenen Repository gilt eine Pilotregel für mehrere plausible lesende Untersuchungen, die sich anhand der vorhandenen Fakten nicht klar priorisieren lassen. Außerhalb davon bleibt die Nutzung freiwillig. Ein regelmäßiger Diagnoseeinsatz und ein nachgewiesener Qualitätsgewinn werden hier nicht behauptet.

Bewertung durch Codex

Eine Empfehlung ersetzt weder Faktenprüfung noch Verantwortung.

Ein weiterer Blick kann bei einer offenen Untersuchungswahl helfen. Er kostet aber Zeit, Modellaufrufe und eine bewusste Auswahl des weitergegebenen Kontexts. Übereinstimmende Anbieterantworten beweisen keine Richtigkeit. Ich würde diese Schicht erst dann als etabliertes Werkzeug bewerten, wenn reale Fälle ihren Mehrwert zeigen; Autorisierung und unabhängiger Review bleiben beim bisherigen Vertrag.

Unverändert: Repository und Runtime bleiben bindend, docs-find führt zu Originalquellen und Akasha bewahrt kuratiertes Wissen. Der Journalablauf bleibt linear. Ungeprüfte lokale Änderungen am versionierten Arbeitsplatz werden nicht als neuer installierter Stand übernommen.

Das System

Drei Arten von Zustand, bewusst nicht vermischt.

bindendRepository & Runtimeaktuelle technische Wahrheit
findendocs-findlokale Originale
arbeitenCodexJournaloperativer Verlauf
kuratiertAkashawiederverwendbares Wissen

Der letzte Übergang ist absichtlich manuell. Ein abgeschlossenes Journal-Ereignis wird nicht automatisch zu dauerhaftem Wissen.

01

Original statt Index

Suche beschleunigt das Finden. Sie autorisiert keine Aussage und ersetzt weder Code noch DDL oder Laufzeitbeleg.

02

Ereignis vor Erzählung

Das Journal speichert kleine, typisierte Nachweise statt eines vollständigen Transkripts der Arbeit.

03

Kuratiert vor vollständig

Ein leises Gedächtnis mit Lücken ist nützlicher als eine große Sammlung unbestätigter Zusammenfassungen.

Kernwerkzeuge

Was sie lösen – und was sie kosten.

Alle drei Werkzeuge dieses Stands laufen im beschriebenen Entwicklungsworkflow. Keines davon ist als allgemeine Plattform gedacht.

01

Operative Provenienz

CodexJournal

im Einsatz · linear und verkleinert

Hält Ziel, Entscheidungen, Verifikation und Ergebnis einer Arbeitseinheit fest, ohne daraus eine parallele Prozesssteuerung zu machen.

append-only Ereignissedirekte Review-Sessionexpliziter Ressourcenverbleib

Auslöser

Git zeigt Änderungen, aber nicht zuverlässig Ziel, bewusste Nicht-Änderungen, Review-Ergebnisse oder den Grund für einen Abbruch. Zusätzliche Koordinationsflächen können dieses Problem jedoch selbst verdoppeln.

Mechanik

MCP-Werkzeuge schreiben semantische Ereignisse in ein append-only PostgreSQL-Journal; technische Hooks ergänzen Session-Fakten. Historische Change-Control- und Review-Launcher-Ereignisse bleiben lesbar. Shared Notes, strukturierte Kontextbewertung, Launcher und Companion gehören nicht mehr zur aktiven Werkzeugfläche.

Im Ablauf

Der normale Weg ist Aufgabe, Slice, Implementierung, Tests, bei Bedarf ein unabhängiger Review in einer getrennten Codex-Session und Abschluss. Das Journal hält Nachweise fest, autorisiert aber keine Repository-Aktion. Temporäre Ressourcen werden vor dem Abschluss bewusst aufgeräumt oder übergeben.

Grenze / Trade-off

Auch der kleinere Vertrag bleibt zusätzliche Prozess- und Betriebsinfrastruktur. Für kurze Arbeiten reichen Commit und Tests oft aus. Der Write-only-Briefkasten bleibt ein optionales Signal und darf weder Journalentscheidung noch Gate werden.

Oberfläche ·

Change Control im Ausschnitt.

Zwei reale Slices derselben devMCP-Änderung zeigen den entscheidenden Übergang: Das erste revisionsgebundene Review endet mit drei konkreten Befunden. Der spätere Implementierungsslice weist die korrigierte Revision, das bestandene Re-Review und die erfüllten Gates aus. Integration und Deployment bleiben dort noch bewusst ein eigener Schritt.

Kontrollierte, datierte Ausschnitte: Session- und Slice-IDs, Links, Live-Telemetrie sowie konkrete sicherheitsrelevante Betriebsdetails wurden durch die Auswahl weggelassen. Die Bilder belegen eine Projektion, nicht den heutigen Runtime-Zustand oder ein festes UI-Versprechen.

01 · Review · Vollbild ↗CodexJournal-Ausschnitt eines nicht bestandenen revisionsgebundenen Reviews mit drei endlichen Befunden
02 · Re-Review · Vollbild ↗CodexJournal-Ausschnitt der korrigierten Revision mit bestandenem Re-Review, erfüllten Gates und letztem Stand
CodexDashboard · zwei kontrollierte Ausschnitte vom 12.08.2026
02

Kuratiertes Arbeitsgedächtnis

Akasha

im Einsatz · kanonische Auflösung aktiv

Bewahrt Entscheidungen, Fehlermuster und echten Wiederaufnahmekontext über einzelne Aufgaben hinweg auf.

PostgreSQL + pgvectorTypen + TTL + Supersessionsemantische Suche

Auslöser

Wiederverwendbare Erkenntnisse verschwinden in Chats und Notizen. Das Gegenextrem – jede Sitzung vollständig zu speichern – erzeugt jedoch ein lautes, widersprüchliches Gedächtnis.

Mechanik

Ein .NET-MCP-Server speichert kompakte Einträge in PostgreSQL mit pgvector. Semantische Suche wird mit Metadaten wie Projekt, Typ und Scope kombiniert. Temporärer Session-Kontext erhält standardmäßig eine TTL; explizite Supersession-Beziehungen lösen Treffer zu kanonischen Einträgen auf.

Im Ablauf

Zu Beginn wird nach passendem Wissen gesucht. Gespeichert wird nur bestätigtes, außerhalb des aktuellen Slices nützliches Wissen – oder ein wirklich benötigter Übergabestand. Repository und aktuelle Dokumentation bleiben maßgeblich.

Grenze / Trade-off

Suche und Query bleiben strikt lesend; abgelaufene Einträge werden nur durch eine explizite Bereinigung gelöscht. Supersession löst Widersprüche dennoch nicht allgemein: Ersetzungen müssen ausdrücklich referenziert werden. Zyklen, ungültige Beziehungen und konkurrierende terminale Nachfolger werden fail-closed als Konflikt behandelt; fehlende Ziele bleiben dagegen diagnostisch sichtbar und erzeugen keinen Platzhalter. Retrieval bleibt probabilistisch und Metadaten brauchen Pflege. Für wenige stabile Notizen ist eine versionierte Markdown-Datei einfacher.

03

Originalquellennavigation

docs-find

im Einsatz · lokal und deterministisch

Ordnet Projekt- und Source-Keys direkt lokalen Repository-Originalen zu und durchsucht Dokumentation und DDL mit ripgrep.

versioniertes MappingOriginaldateien + ripgrepkein Index oder Netzwerk-Fallback

Auslöser

Repositoryübergreifende Arbeit braucht einen stabilen Einstieg, ohne vor jeder Aussage einen entfernten Index, Embeddings oder einen veröffentlichten Scanstand vorauszusetzen.

Mechanik

Ein versioniertes Mapping verbindet Git-Origins, mögliche Checkout-Wurzeln und freigegebene Dokument- oder DDL-Pfade. Der aktuelle passende Worktree gewinnt; fehlende oder mehrdeutige Quellen brechen sichtbar ab. Suche läuft ohne Index, persistenten Dokument- oder Inhaltscache, Auto-Clone oder Netzwerk-Fallback direkt auf den Dateien.

Im Ablauf

Nach dem Akasha-Kontext wird zuerst das Projekt lokal aufgelöst. Dokumentation und DDL werden in den gemappten Originalen gesucht; für Code und nicht gemappte Quellen folgt normales ripgrep im aufgelösten Checkout. Erst der gelesene Originalstand autorisiert die Aussage.

Grenze / Trade-off

Determinismus und geringe Betriebsfläche kosten semantisches Ranking, zentrale Veröffentlichung und maschinenübergreifende Verfügbarkeit. Das Mapping muss gepflegt werden und setzt lokale Checkouts voraus. Für große, verteilte Korpora kann ein Index weiterhin sinnvoller sein.

Tatsächlicher Ablauf

Ein kleiner Kontrollkreis, kein autonomes Wissenssystem.

  1. 01Kontext

    Akasha nach wiederverwendbarem Wissen durchsuchen.

  2. 02Quelle

    Mit docs-find das lokale Original auflösen und direkt lesen.

  3. 03Slice

    Ziel und Grenze festlegen; einen unabhängigen Review nur nach Risiko, Auftrag oder bindender Regel einsetzen.

  4. 04Arbeit

    Implementieren, prüfen und Abweichungen sichtbar halten.

  5. 05Abschluss

    Ergebnis und Verifikation im Journal dokumentieren.

  6. 06Promotion

    Nur dauerhaftes Wissen bewusst nach Akasha übernehmen.

Lokale Infrastruktur

Aspire + OpenTelemetry

Ein versioniertes, nur lokal gebundenes Aspire Dashboard sammelt Entwicklungslogs, Traces und Metriken mehrerer Anwendungen über OTLP/HTTP. Das hilft bei verteilten Fehlern, ohne daraus ein Produktions-Monitoring zu machen.

Anwendungen→OTLP→Aspire

Grenze: Container, Exportkonfiguration und Datenvolumen sind zusätzlicher lokaler Betrieb. Für eine einzelne Anwendung ist strukturiertes Logging oft ausreichend.

Weiterentwickeltes Experiment

SimpleDisplay

Eine kleine macOS-Menüleisten-App verwaltet Displays und erzeugt virtuelle Monitore für Remote-Arbeit und UI-Tests. Persistierte Seriennummern halten virtuelle Display-Identitäten über Neustarts stabiler als flüchtige Laufzeit-IDs.

Grenze: Die Lösung verwendet private Apple-APIs, ist nicht App-Store-tauglich und kann durch ein macOS-Update brechen. Das ist eine bewusste Plattformwette, kein allgemeines Display-Framework.

Nichtproduktive Infrastruktur

Parat-Lab

Ein kleiner, revisionsgebundener Zielaufbau prüft die Anwendung als zusammenhängendes System: statische Release-Artefakte, bereinigte realistische Persistenz, echter Browser, Restore und ein endlicher Aktivierungs- und Rollbackpfad.

Browser→Frontend→Backend→Testdaten

Grenze: Die Umgebung ist kein Produktionsklon. Datenrealismus ist nur mit reproduzierbarer Bereinigung, Negativprüfungen und belegtem Wiederanlauf vertretbar; weitere Erweiterungen benötigen eigene Gates.

Erwartbar offline · fest verdrahtet

Drei getrennte Systemsimulationen

Eine Referenzinstallation und zwei feste weitere Installationen prüfen dieselben Produktgrenzen mit getrennten Anwendungs-, Daten- und Sitzungskontexten. Der Aufbau bleibt manuell erneuerbar und verzichtet auf Discovery oder dynamische Mandantenauflösung.

Browser→feste Webkante→eigene Apps→getrennte Daten

Grenze: Getrennte Datenbanken und Rollen beseitigen nicht den gemeinsamen Ausfallbereich der Datenbankprozesse. Sichtbare Konfiguration ersetzt außerdem keinen vollständigen Frontend- und Accessibility-Nachweis.

Private Dokumentationskopie

Obsidian als mobile Leseschicht

Freigegebene Markdown-Originale werden über das lokale Dokument-Mapping in einen privaten Vault kopiert. Beim Publizieren werden verwaltete Kopien mit der Repository-Fassung überschrieben, auch nach lokalen Änderungen. Der Publisher erzeugt keine Konfliktkopien oder eigene Historie und schreibt nicht ins Repository zurück.

Repository→lokales Mapping→Vault

Grenze: Änderungen an verwalteten Kopien können bei der nächsten Publikation verloren gehen. Synchronisation, Plug-in und Backup bleiben zusätzlicher Betrieb. Eine lokale Publikation allein belegt noch keine Synchronisation auf ein mobiles Gerät.

Versionierter Arbeitsplatz

Codex Workstation

Ein privater, prüfbarer Vertrag bündelt die portablen Teile des Entwicklungsrechners und installiert sie komponentenweise. Die führende Maschine autorisiert Änderungen; weitere Geräte dürfen nur bewusst ausgewählte Git-Stände übernehmen.

Quelle→Prüfung→Auswahl→lokaler Zustand

Grenze: Logins, Secrets, Sessions, Memories, breite Trust-Entscheidungen, Live-Automationen und hardwarespezifische Laufzeitdaten bleiben absichtlich außerhalb dieses Vertrags.

Werkzeugmuseum

Nicht jede hilfreiche Schicht muss bleiben.

Hier landen Werkzeuge, die real gebaut und verwendet wurden, deren Aufgabe im aktuellen Workflow aber entfallen ist.

retired12.08.2026erstes Exponat

Externe Slice-Orchestrierung

CodexSlicer

Zerlegte größere Arbeiten in kontrollierbare Codex-Runs, als der Agent diese Struktur, ihre Gates und ihre Übergaben noch nicht zuverlässig selbst halten konnte.

damalsCLI als ZustandsmaschinePlan · Preflight · Attempts · Checks · Scope-Gates
heuteOrchestrierung im AgentenSlice · Quellen · Revision · Review · Ergebnis

Was tatsächlich gebaut war

Eine .NET-10-CLI plante Modellversuche, prüfte benötigte MCP-Server, startete codex exec, schrieb Laufartefakte und bewertete Checks sowie neue Git-Änderungen gegen explizite Scope-Grenzen.

Warum sie gehen konnte

Im heutigen interaktiven Workflow führt Codex diese Orchestrierung, Revisionsbindung und Verifikation selbst. Die zusätzliche CLI verdoppelte Planung, Zustand und mögliche Fehlerpfade, ohne hier noch denselben Sicherheitsgewinn zu liefern.

Was geblieben ist

Begrenzte Slices, explizite Voraussetzungen, harte Scope-Grenzen und reproduzierbare Checks. Verschwunden ist die zusätzliche Laufzeit, nicht die dahinterliegende Disziplin.

Kein allgemeines Todesurteil

Für unbeaufsichtigte oder streng deterministische Batch-Pipelines kann ein externer Runner weiterhin sinnvoll sein. Retired bedeutet hier: für diesen Workflow ersetzt.

retired01.09.2026ersetzt im Standardworkflow

Indexierte Quellennavigation

devMCP

Synchronisierte Dokumentation, DDL, Code und Endpoints in einen semantisch durchsuchbaren Dienst mit atomarer Veröffentlichung, Readiness und Repairpfaden.

damalsEntfernter IndexScan · Chunks · Embeddings · Readiness
heuteLokale OriginalquellenMapping · Worktree · Datei · ripgrep

Was tatsächlich gebaut war

Registrierte Quellen wurden versioniert erfasst, in unveröffentlichte Kandidaten überführt und erst nach vollständigen Pflichtjobs atomar sichtbar. Manifeste, Readiness und Reparatur machten unvollständige Stände diagnostizierbar.

Warum es gehen konnte

Der aktuelle Workflow muss bindende Aussagen ohnehin am lokalen Original prüfen. Für die vorhandenen Repositories erzeugte der Index mehr Zustands-, Betriebs- und Aktualisierungsarbeit, als sein semantisches Ranking sparte.

Was geblieben ist

Stabile Projekt- und Source-Keys, explizite Originalquellenrollen, sichtbare Drift und die Trennung von Navigation und Autorität. Ersetzt wurde die Laufzeit, nicht die Provenienzdisziplin.

Kein allgemeines Todesurteil

Für große, verteilte oder überwiegend semantisch erschlossene Korpora kann ein veröffentlichter Index wieder sinnvoll sein. Die deaktivierte Definition bleibt deshalb als begrenzter Rückfall erhalten.

Quellenlage

Was dieser Stand behauptet – und was nicht.

Belegt durch

  • aktuelle Repository-Dokumentation und Architekturentscheidungen
  • Implementierung, Tests und veröffentlichte Werkzeugverträge
  • installierte lokale Quellennavigation und tatsächliche Werkzeugkonfiguration
  • Journal nur für Entstehung, Nutzung und Prozessgrenzen

Bewusst nicht behauptet

  • dass jeder dokumentierte Plan bereits implementiert ist
  • dass ein von Akasha als aktuell aufgelöster Treffer die kanonische Repository-Quelle ersetzt
  • dass Journal und Akasha automatisch gekoppelt sind
  • dass lokale Infrastruktur ein übertragbares Produkt darstellt
  • dass zwei Rechner vollständig oder automatisch synchronisiert sind
Chronik-Vertrag v1CodexJournal 27fe720 · aktiver Dashboard-Standdeliberate f351dce · konfigurierter Pilotdev-infra 39f5fe3 · DokumentationspublisherAkasha a83c9ee · QuellenvertragCodex Workstation 356e12b · versionierter VertragsstanddevMCP ff5191d · retired im StandardworkflowSimpleDisplay c576ccbCodexSlicer fc68381