Michael TamseandClaude
2a557c3680
- 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>
36 lines
2.1 KiB
Markdown
36 lines
2.1 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
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.
|
|
|