feat: Story 2.2 Claim-granulare Provenienz dokumentieren (Review fertig)
schema/compiler.md §5.5 als Beweis-Konvention (Inline-raw-Verweise je belegter Aussage, Kontext-Marker je Uebernahme, id-Scoping §3.3, worked example); Revision 1.5/1.6. 3 Concept-Bodies nachkonformiert (Diagramm-Quellen als sources-Eintraege deklariert, keine Selbstreferenz, volle raw-Pfade). index.md/log.md nachgefuehrt; sprint-status Story 2.2 -> review. Review 3 Layer: 7 patch + 1 defer (sources-Closure) verankert; spec -> done inkl. Suggested Review Order. Keine raw/-/Vertrag-Mutation. Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -2,6 +2,9 @@
|
||||
type: concept
|
||||
sources:
|
||||
- resource: raw/architecture-spine/architecture-spine-2026-08-14.md
|
||||
id: s1
|
||||
- resource: raw/prd/prd-wow20-2026-08-14.md
|
||||
id: s2
|
||||
generated:
|
||||
by: wow-compiler/0.1.0
|
||||
at: 2026-08-16T09:23:33Z
|
||||
@@ -9,14 +12,14 @@ generated:
|
||||
|
||||
# Wissensarchitektur: Source Material, Curated Knowledge & Consumer
|
||||
|
||||
Die Architektur von Wiki of Wikis trennt drei Verantwortungsbereiche, die nie vermischt werden dürfen: Quellen, Kompilation und kuratiertes Wissen mit seinen Konsumenten (AD-2, AD-3, AD-1).
|
||||
Die Architektur von Wiki of Wikis trennt drei Verantwortungsbereiche, die nie vermischt werden dürfen: Quellen, Kompilation und kuratiertes Wissen mit seinen Konsumenten (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-2, #AD-3, #AD-1; raw/prd/prd-wow20-2026-08-14.md, § 8.3 Separation of Concerns).
|
||||
|
||||
## Die Architekturgrenzen `raw/` und `wiki/`
|
||||
|
||||
- **`raw/` — immutable Source Material/Evidenz:** Jede Datei unter `raw/` ist Evidenz. Ein Compilation Run darf bestehendes Source Material niemals verändern (AD-3); neue Versionen einer Source werden als neue beziehungsweise versionierte Source behandelt.
|
||||
- **`wiki/` — kuratiertes OKF Knowledge Bundle:** Jede Datei unter `wiki/` ist eine aus Evidenz abgeleitete Wissensrepräsentation. Das Bundle ist der kanonische persistente Zustand des Systems (AD-1).
|
||||
- **`raw/` — immutable Source Material/Evidenz:** Jede Datei unter `raw/` ist Evidenz. Ein Compilation Run darf bestehendes Source Material niemals verändern (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-3); neue Versionen einer Source werden als neue beziehungsweise versionierte Source behandelt (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-3).
|
||||
- **`wiki/` — kuratiertes OKF Knowledge Bundle:** Jede Datei unter `wiki/` ist eine aus Evidenz abgeleitete Wissensrepräsentation. Das Bundle ist der kanonische persistente Zustand des Systems (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-1; raw/prd/prd-wow20-2026-08-14.md, § 8.2 Plain Files as Canonical State).
|
||||
|
||||
Das bloße Kopieren eines Source-Dokuments nach `wiki/` ist keine Kompilation.
|
||||
Das bloße Kopieren eines Source-Dokuments nach `wiki/` ist keine Kompilation (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-2; raw/prd/prd-wow20-2026-08-14.md, § 8.3 Separation of Concerns).
|
||||
|
||||
## Separation of Concerns
|
||||
|
||||
@@ -24,21 +27,23 @@ Das bloße Kopieren eines Source-Dokuments nach `wiki/` ist keine Kompilation.
|
||||
Sources → Compilation → Knowledge Bundle → Consumers
|
||||
```
|
||||
|
||||
- Eine Source darf nicht automatisch Teil des Curated Knowledge werden.
|
||||
- Ein Consumer darf nicht zur Voraussetzung für Kompilation oder Speicherung werden.
|
||||
- Der Compiler ist ein Producer des Bundle-Artefakts — kein Wissensserver und keine eigene Agent-Runtime (AD-11).
|
||||
> Das Diagramm (Sources → Compilation → Knowledge Bundle → Consumers) stammt direkt aus der rohen Quelle `raw/prd/prd-wow20-2026-08-14.md` (§ 8.3 Separation of Concerns) — übernommen aus `raw/prd/prd-wow20-2026-08-14.md` (rohe Quelle), nicht eigenständig belegt.
|
||||
|
||||
- Eine Source darf nicht automatisch Teil des Curated Knowledge werden (raw/prd/prd-wow20-2026-08-14.md, § 8.3 Separation of Concerns).
|
||||
- Ein Consumer darf nicht zur Voraussetzung für Kompilation oder Speicherung werden (raw/prd/prd-wow20-2026-08-14.md, § 8.3 Separation of Concerns).
|
||||
- Der Compiler ist ein Producer des Bundle-Artefakts — kein Wissensserver und keine eigene Agent-Runtime (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-11).
|
||||
|
||||
## Consumer-Unabhängigkeit
|
||||
|
||||
Das Knowledge Bundle ist nicht auf einen bestimmten LLM-Agenten oder Workflow zugeschnitten (FR-16). Menschen lesen es mit normalen Markdown-Werkzeugen; Agenten wie BMAD, Claude Code oder Codex über Standard-Dateioperationen. Ein Wechsel des Consumers erfordert keine Migration des Wissensformats.
|
||||
Das Knowledge Bundle ist nicht auf einen bestimmten LLM-Agenten oder Workflow zugeschnitten (raw/prd/prd-wow20-2026-08-14.md, § 4.5 FR-16). Menschen lesen es mit normalen Markdown-Werkzeugen; Agenten wie BMAD, Claude Code oder Codex über Standard-Dateioperationen. Ein Wechsel des Consumers erfordert keine Migration des Wissensformats (raw/prd/prd-wow20-2026-08-14.md, § 4.5 FR-16).
|
||||
|
||||
Retrieval (Search, RAG, Graph-Traversal) ist Consumer-Verhalten, nicht Kern des Compilers (AD-13).
|
||||
Retrieval (Search, RAG, Graph-Traversal) ist Consumer-Verhalten, nicht Kern des Compilers (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-13; raw/prd/prd-wow20-2026-08-14.md, § 5 Non-Goals).
|
||||
|
||||
## Konvergenzregeln
|
||||
|
||||
| Betrachtet | Quelle |
|
||||
|---|---|
|
||||
| Canonical evidence | `raw/` bzw. referenzierte externe Source |
|
||||
| Canonical knowledge | `wiki/` |
|
||||
| Discovery | Hierarchie + `index.md` |
|
||||
| Update history | Git + optional OKF `log.md` |
|
||||
| Canonical evidence | `raw/` bzw. referenzierte externe Source (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-4b) |
|
||||
| Canonical knowledge | `wiki/` (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-1) |
|
||||
| Discovery | Hierarchie + `index.md` (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-9) |
|
||||
| Update history | Git + optional OKF `log.md` (raw/architecture-spine/architecture-spine-2026-08-14.md#AD-14) |
|
||||
|
||||
Reference in New Issue
Block a user