41 lines
8.1 KiB
Markdown
41 lines
8.1 KiB
Markdown
---
|
|
scope: Wiki of Wikis MVP
|
|
purpose: build-substrate
|
|
altitude: initiative
|
|
topic: Wiki of Wikis Architecture-Spine (LLM Wiki Compiler / OKF 0.2 / agent-native compiler pipeline)
|
|
updated: 2026-08-14T18:03
|
|
---
|
|
|
|
- (event) Run gestartet: Create aus vollständigem Nutzer-Entwurf (Headless/Kein interaktives Coaching); PRD-wow20-2026-08-14 als treibendes Spezifikations-Input; Karpathy-Gist und OKF-SPEC 0.2 auf Web verifiziert (beide existent, Aussagen korrekt)
|
|
- (decision) AD-1 Kanonischer Zustand = OKF Knowledge Bundle (wiki/); derived Artifacts (Indizes, Embeddings, Caches) niemals Source of Truth; gebunden an FR-9..FR-16, NFR-1..NFR-6
|
|
- (decision) AD-2/3 Sources (raw/) und kuratiertes Wissen (wiki/) physisch+semantisch getrennt; Sources immutable; Kopie nach wiki/ ist keine Compilation; FR-1..FR-8
|
|
- (decision) AD-4 Generiertes Wissen bleibt Source-grounded: Wiki-Links tragen Navigation/Beziehungen, ersetzen nicht Provenienz; Synthesekette transitiv auf echte Sources zurückführbar; deckt Karpathy/community 'never self-grounding' ab (Antwort auf PRD OQ-2/PRD-Frage Human-authored)
|
|
- (decision) AD-5/6 Incremental Compilation (bestehendes Bundle als Input, nur betroffene Concepts ändern); Reasoning von Mutation getrennt (Analyze/Reconcile/Plan/Mutate/Validate); kein Misch-Modus; FR-4..FR-8, FR-12
|
|
- (decision) AD-7 Concept-Identität = relativer OKF-Pfad ohne .md (z.B. flowable/timers); Rename ist semantische Änderung; AD-8 Beziehungen via Standard-Markdown-Links, Graph nur abgeleitet; AD-9 Discovery via Hierarchie+index.md; FR-9..FR-12, FR-15
|
|
- (decision) AD-10 Compiler-Regeln agent-unabhängig (kanonischer Contract, Adapter als dünne Hüllen); AD-11 MVP: keine eigene LLM-Runtime, kein Serverprozess; AD-12 Source-Beschaffung außerhalb Compiler-Kern; AD-13 Retrieval gehört zu Consumers; FR-15/FR-16, NFR-6, MVP-Boundary
|
|
- (decision) AD-14 Git liefert History/Diff/Attribution, nicht Domain-State; fachliche Provenienz bleibt in OKF; AD-15 Human- und Machine-Curation teilen dasselbe OKF-Modell (kein separates Datenmodell); FR-13, FR-14, NFR-2, NFR-4
|
|
- (decision) Antwort PRD OQ-4 (Conflict Resolution): Compiler klassifiziert NEW/CONFIRMING/CORRECTING/CONTRADICTING/REDUNDANT; Widersprüche bleiben explizit erhalten statt still zusammengeführt; keine stillschweigende Auflösung
|
|
- (assumption) A-Arch1 MVP: bestehende leistungsfähige Agent-Runtime (z.B. Claude Code) übernimmt Reasoning + Dateioperationen; kein eigener Serverprozess; Standalone-Implementierung deferred (D-3)
|
|
- (assumption) A-Arch2 AD-4: generiertes Concept darf NIE als alleinige Provenienz eines anderen Concepts dienen; Wiki-Links sind Navigation, keine Grounding-Kette (entspricht Karpathy-Community) — als ASSUMPTION, Resttrennung offen (Q-1)
|
|
- (assumption) A-Arch3 AD-6: Compiler darf Phasen technisch in einer Session ausführen; nur beobachtbarer Endzustand muss konsistent sein (keine Workflow-Engine nötig)
|
|
- (version) OKF-Version als normative Bindung: Open Knowledge Format 0.2 (type einzige Pflicht-Frontmatter; sources/generated/verified [human:-Präfix]/status/stale_after optionale Familien; okf_version nur in Bundleroot-index.md; references/-Konvention); verifiziert gegen GoogleCloudPlatform/knowledge-catalog/okf/SPEC.md
|
|
- (feature) Verteilte Producer-Konvention (Koordinierung): Producer-Adapter MÜSSEN wiki/<area>/Producers.md pflegen (kollektives 'who owns this'; Dürfen-Klausel über Production der jeweils anderen Bereiche); verhindert Last-Writer-Wins bei unkoordinierten Compilern; Cover auch Human-Curation
|
|
- (direction) Feature-relevante Widersprüche (Contradictions verschiedener Producer, Klärung möglich, strittig für Build): CONTRADICTION-Discussion in log.md statt Autoklärung; direkt inkonsistent: Autoklärung entfällt
|
|
- (constraint) PRD-Hard-Boundary: Kein Vector-/Embedding-/Knowledge-Graph-DB-/MCP-/Server-/Retrieval-Kern im MVP (Non-Goals); Relevanzbestimmung (PRD OQ-3) mit textuell-deterministischen Mitteln; Verfehlung = Conflict (AD-answer)
|
|
- (constraint) Produktname: 'Wiki of Wikis' als Projektname für den MVP fixiert (PRD OQ-6 weiterhin offen für finalen Produktnamen/PM)
|
|
- (question) Q-3 Source-Rohs/Externe Location: Müssen alle Sources physisch unter raw/ liegen oder darf raw/ stabile Referenzen auf externe immutable Ressourcen enthalten? (betrifft Source-Identität + Reproduzierbarkeit; muss vor FR-1-Implementierung geklärt werden)
|
|
- (question) Q-2 Producer-Overlap-Subownership: Können sich Producer gegenseitig in nicht-owned Bereichen ergänzen/korrigieren (produktiv) oder ist Production strikt auf owned Bereiche beschränkt? (Standardfall-basierte Antwort als Design-Prinzip im Spine belassen)
|
|
- (question) Q-1 AD-4 Source Grounding: Verbleibende Resttrennung — Dürfen Concepts überhaupt stillschweigend von anderen Concepts abgeleitet werden oder trennende Ownership/Link-Semantik?
|
|
- (assumption) Seed-Architektur (Kein Star): distributed Concept Ownership via Produces-Datei ist das Referenzdesign; Meta-Monopol/Rad-Schirm (star), zentrale Coordination-DB, zentrale Producer/Pipeline-Orchestrierung, Request/Response-Queue sind abgelehnt als Zirkel
|
|
- (decision) Stack bewusst minimal: leere Stack-Tabelle + Deklarations-Zwischenung (technologie-nicht-gebunden; alles was später eingeführt wird muss Begründung geben, warum Agent-Runtime+Filesystem nicht ausreicht)
|
|
- (decision) Structural-Seed-Pfade fixiert (nicht Template-Kommentar): raw/, wiki/, schema/wiki-compiler.md, adapters/ (claude/, codex/); raw/ und wiki/ sind Architekturgrenzen; Rest ist Seed
|
|
- (event) Tech-Currency-Review: 'Keine committed Entscheidung auf unverifizierter/veralteter Technologie'; OKF 0.2 aktuell und Spine-Darstellung auf jedem Punkt korrekt; Karpathy-Gist existent, aber Provenienz-und-kein-Self-Grounding-Verbot (AD-4/AD-16) stammt aus dem Kommentar-Thread, nicht wörtlich aus dem Gist — Spine ist strenger als Quelle, vertretbar; kein verstecktes LLM/Agent-Framework-Assumption
|
|
- (event) Reconcile-Review: alle 16 FRs/7 NFRs getragen, keine Assumption-Widersprüche, keine Non-Goal-Rücknahme; OQ-2/3/4 beantwortet (AD-15/17/16); Hoch: OQ-6 Produktname stillschweigend final + OQ-5 Source-Lifecycle nur D-5; Mittel: A-1/SM-C3 Mensch-korrigierbar-Metrik ungetragen, NFR-3 nicht explizit gebunden, AD-3 immutable-vs-lifecycle-Spannung; Klein: A-3 kein GUI, status-stable-vs-draft
|
|
- (event) OKF/Spec-Review: PASS — 16/16 FRs, 7/7 NFRs gecovert; Tickets AD-15/AD-17/AD-16 beantwortet; Konformitäts-Kleinigkeiten: F-1 Bundleroot/generation-rook nicht explizit (Unterordner-index.md ohne Frontmatter außer Bundleroot-Ausnahme), F-2 'ungültig' muss strukturell definiert werden (MUST-NOT-reject bei optionalen Feldern), F-3 log.md-Ledger muss §9-Datumsgruppen-Format halten; keine Dialekt-Risiken
|
|
- (event) Adversarial-Review: F-1/F-2 CRITICAL, F-3/F-4 HIGH, F-5/F-6/F-7 MEDIUM; Kern: AD-17 Lease-Mechanismus/Scope/Staleness + log.md unter LWW (F-1); AD-7/AD-8 doppelte ID-Normalisierung & Linkform (F-2); AD-4 nur Concept-Ebene, kein Claim-Grounding, sources-tutorial auf wiki/ verboten (F-3); CONTRADICTING-vs-CORRECTING nicht deterministisch (F-4); Dirty-Tree-Schutz (F-5); schema/wiki-compiler.md ungebunden + log.md nicht OKF-tippbar (F-6); 'produktiver Nutzen' nicht entscheidbar, Determinismus-Kontrakt fehlt (F-7)
|
|
- (event) Reviewer-Gate (Finalize): lint clean + 5 unabhängige Reviews (Rubrik / Tech-Currency / Adversarial / OKF-Spec / Reconcile). Ergebnis aggregiert und Korrekturen angewendet
|
|
- (decision) Spine nach Gate geschärft: AD-4 um Claim-Granularit/source-grounding-Subrules ergänzt; AD-7 um ID-Normalisierung/Link-Form/Area-Zuordnung/Rename ergänzt; AD-16 um Defaults-Bewahrung; AD-17 um Lease-Vertrag/Root-Scope/Auto-Merge-Verbot/Dirty-Tree/Commit-Grenze/Auflösungs-Autorität/Determinismus; FT-9/FT-10 neu; Q-4/Q-5/Q-6, D-9/D-10, Environments&Acess neu
|
|
- (version) Fitness-Tests erweitert auf FT-10 (Determinismus/Reproduzierbarkeit); Open Questions Q-1..Q-6; Deferred D-1..D-10
|
|
- (direction) v1-Umsetzung mit Determinismus-Kontrakt (AD-17h/FT-10) als Agent-Instruktion bis D-3; Schema-Bindung schema/wiki-compiler.md als verbindliches Artefakt (AD-1a)
|
|
- (event) Spine finalisiert (status: final, updated 2026-08-14); Reviews nach reviews/; lint clean
|