Files
Michael TamseandClaude 2a557c3680 feat: Sources lokal unter raw/ materialisieren (Story 1.2)
- PRD, Architecture-Spine und epics als erste Evidenz-Sources unter raw/
  materialisiert (Per-Quelle-Verzeichnis + source.md Provenienz-Sidecar)
- raw/README um Quellen-Konvention erweitert (Benennung, additive
  Versionierung AD-3, Artefakt-Carve-out, lokale statt URL-Fetches)
- sprint-status.yaml: Story 1.2 auf review gesetzt

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-14 20:08:37 +02:00

2.1 KiB

raw/ — Source Material (immutable Evidenz)

Dieses Verzeichnis ist die Architekturgrenze für Source Material (AD-2, AD-3, AD-12).

  • Eine Datei unter raw/ ist Evidenz.
  • raw/ ist immutable: Ein Compilation Run verändert bestehendes Source Material niemals (AD-3).
  • Neue Versionen einer Source werden als neue bzw. versionierte Source behandelt.
  • Quellen werden hier lokal materialisiert; URL-Abrufe sind im MVP nicht unterstützt (A-4).

Unterverzeichnisse (z.B. assets/) können je nach Quelle ergänzt werden. Die Quelle selbst wird nie automatisch nach wiki/ kopiert — das Kopieren eines Quell-Dokuments ist keine Wissensintegration (FR-2).

Quellen-Konvention

Jede Quelle liegt in einem eigenen Verzeichnis raw/<quelle>/ mit dem Quelldokument und optional einer source.md (Provenienz-Sidecar: kanonische Herkunft, Kopierdatum, Kurzbeschreibung). Die Benennung folgt <quelle-kebab-case>-<jjjj-mm-tt>.md; Verzeichnisname und Dateiname nutzen denselben kebab-case-Namen der Quelle (AD-3). Eine neue Version einer Quelle wird additiv als neue, datierte Datei angelegt (z.B. prd-wow20-2026-08-15.md) — bestehende Dateien unter raw/ bleiben unverändert (Immutable Evidenz, AD-3). source.md ist als Grenz-/Artefakt-Datei (Orientierung) keine Evidenz; ihre Einträge sind Reproduktionshinweise, nicht das eigentliche Source Material.

Beispiel:

raw/
  prd/
    prd-wow20-2026-08-14.md   # Evidenz
    source.md                 # Artefakt (nicht Evidenz)
  epics/
    epics-2026-08-14.md       # Evidenz
    source.md                 # Artefakt (nicht Evidenz)
  architecture-spine/
    architecture-spine-2026-08-14.md   # Evidenz
    source.md                          # Artefakt (nicht Evidenz)
  assets/          # optionale Assets, einer Quelle zugeordnet oder global

Lokal materialisiertes Source Material ist die einzige in v1 unterstützte Eingabe (FR-1, A-4): URL-Abrufe werden zurückgewiesen, es findet keine automatische Internetrecherche statt.

Diese README-Datei ist ein Grenz-/Artefakt-Datei (Orientierung), keine Evidenz; sie markiert die Grenze, ist selbst aber kein zu verarbeitendes Source Material.