Files
chemenu/types/source.md
T
torben b138fd8e64
CI / verify (push) Successful in 53s
Release / release (push) Successful in 35s
move: source_type: Default streichen, unclassified als sichtbares Fach, layout: fuer source (schliesst #66)
Files changed:
- CHANGES.md
- VERSION
- instructions/dev/corpus-policy.md
- instructions/wiki-ingest/SKILL.md
- kb/index.md
- kb/log.md
- kb/sources/COLLECTION.md
- kb/sources/INDEX.md
- kb/sources/Source - AMD Powermanagement CPU.md
- kb/sources/Source - Arch Linux Cheat Sheet.md
- kb/sources/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md
- kb/sources/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md
- kb/sources/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md
- kb/sources/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md
- kb/sources/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md
- kb/sources/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md
- kb/sources/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md
- kb/sources/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md
- kb/sources/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md
- kb/sources/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md
- kb/sources/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md
- kb/sources/Source - Copilot Skill Restructure Instructions.md
- kb/sources/Source - Docker Cheatsheet.md
- kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md
- kb/sources/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md
- kb/sources/Source - LLM Improvements Codex Analysis.md
- kb/sources/Source - LLM Improvements Production Agent Gaps 2026.md
- kb/sources/Source - LLM Improvements Sonnet Analysis.md
- kb/sources/Source - LLM Wiki Pattern.md
- kb/sources/Source - LLM Wiki v2.md
- kb/sources/Source - MCP Read Server Implementation Session 2026-09-02.md
- kb/sources/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md
- kb/sources/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md
- kb/sources/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md
- kb/sources/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md
- kb/sources/Source - Wine.md
- kb/sources/Source - qmd - GitHub Repository.md
- kb/sources/analyses/Source - Copilot Skill Restructure Instructions.md
- kb/sources/analyses/Source - LLM Improvements Codex Analysis.md
- kb/sources/analyses/Source - LLM Improvements Production Agent Gaps 2026.md
- kb/sources/analyses/Source - LLM Improvements Sonnet Analysis.md
- kb/sources/articles/Source - AMD Powermanagement CPU.md
- kb/sources/articles/Source - LLM Wiki Pattern.md
- kb/sources/articles/Source - LLM Wiki v2.md
- kb/sources/documents/Source - qmd - GitHub Repository.md
- kb/sources/notes/Source - Arch Linux Cheat Sheet.md
- kb/sources/notes/Source - Docker Cheatsheet.md
- kb/sources/notes/Source - Wine.md
- kb/sources/trackers/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md
- kb/sources/trackers/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md
- kb/sources/transcripts/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md
- kb/sources/transcripts/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md
- kb/sources/transcripts/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md
- kb/sources/transcripts/Source - MCP Read Server Implementation Session 2026-09-02.md
- kb/sources/transcripts/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md
- kb/sources/transcripts/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md
- kb/sources/transcripts/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md
- kb/sources/transcripts/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md
- tools/CONTRACT.md
- tools/chemenu/lint_core.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_lint.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_provenance.py
- tools/chemenu/tests/test_touch.py
- tools/chemenu/tests/test_type_resolver.py
- tools/chemenu/tests/test_xref.py
- types/source.md
- types/source.schema.yaml
- types/type-spec.md
- work/reclassify-source-types/README.md
- work/reclassify-source-types/plan.md
2026-09-08 20:38:15 +02:00

6.2 KiB

type, name, description, schema, subtype_field, base_dir, title_prefix, page_ref_fields, layout
type name description schema subtype_field base_dir title_prefix page_ref_fields layout
types/type-spec.md source Strukturierter Typ für Source-Seiten, die eingelesenes Rohmaterial erfassen und zusammenfassen types/source.schema.yaml source_type sources Source -
entities
concepts
transcript analysis article document notes tracker unclassified
dir title
transcripts Transkripte
dir title
analyses Analysen
dir title
articles Artikel
dir title
documents Dokumente
dir title
notes Notizen
dir title
trackers Tracker-Exporte
dir title
unclassified Unklassifiziert

Source

source ist der Typ für Seiten, die eingelesenes Rohmaterial zusammenfassen und katalogisieren. Source-Seiten sind die Brücke zwischen der raw/-Schicht (unveränderliche Quelldateien) und der kb/-Schicht (kompiliertes Wissen). Eine Source-Seite steht für eine logische Quelle, die mehrere Raw-Dateien umfassen kann.

Wann zu verwenden

  • Zusammenfassung eines einzelnen externen Artikels, Dokuments oder einer Spezifikation
  • Erfassung mehrerer zusammengehöriger Notizen oder Gesprächsprotokolle als eine Quelle
  • Dokumentation eines eingelesenen PDFs, Handbuchs oder sonstigen Dokuments
  • Festhalten von Informationen zu einem Bild oder Diagramm

Wann NICHT zu verwenden

  • Für kompiliertes Wissen (dann entity oder concept)
  • Für vergleichende Analysen (dann comparison)
  • Für originären Wiki-Inhalt, der nicht aus Rohmaterial abgeleitet ist

Frontmatter

Feld Pflicht Verwendung
type Ja types/source.md
source_type Ja Eines von: transcript, analysis, article, document, notes, tracker, unclassified - kein Default, siehe unten
author Ja Urheber des Quellmaterials
raw_files Ja Raw-Dateipfade, die diese Quelle besitzt - siehe "Eine Raw-Datei, ein Besitzer" unten
source_url Nein Ursprungs-URL bei externen Quellen
source_language Nein ISO-639-1-Code der Sprache des Rohmaterials, z. B. de, en, fr
date Ja Veröffentlichungs- oder Erstellungsdatum (YYYY-MM-DD)
tags Nein Navigations-Tags zur Kategorisierung
entities Nein Titel der in dieser Quelle erwähnten Entities
concepts Nein Titel der in dieser Quelle erwähnten Concepts
summary Ja Einzeiler für kb/index.md

Autorenanweisungen

  • Der Titel beginnt mit "Source - ", gefolgt vom Namen der Quelle
  • source_type hat keinen Default - wikitool new source verweigert ohne einen expliziten Wert. Ist die Kategorie unklar, unclassified setzen statt zu raten; das ist ein sichtbares Katalogfach mit beratendem lint-Befund, kein Sammelbecken. Was analysis von document trennt und welche Area welchen Wert hält: kb/sources/COLLECTION.md
  • raw_files listet jede Raw-Datei, die diese Quelle abdeckt (eine Source-Seite pro logischer Quelle, nicht pro Datei)
  • Bei externen Artikeln immer source_url auf die Ursprungs-URL setzen
  • source_language auf die Sprache des Rohmaterials setzen, nicht auf die der Seite
  • Die Seite wird in der KB-Sprache geschrieben, unabhängig von der Sprache der Quelle; wörtliche Passagen werden im Original zitiert (kb/CONVENTIONS.md § "Language")
  • Kernaussagen im Abschnitt Summary zusammenfassen
  • Handlungsbedarf in den Abschnitt Action Items
  • Bewusst Weggelassenes in den Abschnitt Not Extracted - siehe unten
  • Erwähnte Entities und Concepts unter Related Entities/Concepts verlinken

Not Extracted

Die Entscheidung, dass Material nicht übernommen werden soll, ist nicht rekonstruierbar: nichts im Repository kann sie neu herleiten, und sources coverage weiß nur, ob eine Raw-Datei von irgendeiner Source-Seite beansprucht wird - nie, ob jemand über ihren Inhalt entschieden hat. Bleibt das unaufgeschrieben, wird dieselbe Quelle bei jedem späteren Durchgang neu verhandelt.

  • Jede bewusste Auslassung mit Begründung festhalten, nicht nur mit Dateinamen.
  • Pflicht, wenn der Ingest als Tree-Ingest lief (siehe instructions/ingest-large-tree.md). Optional bei einer einzelnen kleinen Datei - aber ein leerer Abschnitt ist immer noch besser als ein fehlender.
  • Gehört auf die Source-Seite, nicht in kb/log.md: es ist eine Aussage über diese Quelle, und das Log ist chronologisch, nicht quellenbezogen.

Template

# Source: {name}

**Autor:** {author}  
**Datum:** {date}  
**Raw-Dateien:** {raw_files|join}  
**Typ:** {source_type|capitalize}

## Zusammenfassung

TODO: 2-3 Absätze zu den Kernaussagen des Quellmaterials.

## Kernaussagen

- TODO: Kernaussage 1
- TODO: Kernaussage 2
- TODO: Kernaussage 3

## Aufgaben

- [ ] TODO: Aufgabe 1
- [ ] TODO: Aufgabe 2

## Nicht übernommen

- TODO: Was bewusst nicht übernommen wurde, und warum (oder "nichts - die Quelle wurde vollständig erfasst")

## Verwandte Entities

{entities|bullets}

## Verwandte Concepts

{concepts|bullets}

# Source: bleibt als Präfix stehen - es spiegelt den title_prefix und damit den Titel, unter dem die Seite verlinkt und zitiert wird. Der Wert hinter **Typ:** bleibt der englische Enum-Wert. Fügt wikitool cite ein Zitat hinzu, entsteht am Seitenende der toolgeführte Fußnoten-Block; wie er heißt, entscheidet die Instanz in kb/CONVENTIONS.md (sections:).


Ergänzende Hinweise:

  • Source-Seiten sind der maßgebliche Katalog dessen, was an Rohmaterial eingelesen wurde
  • Eine Raw-Datei, ein Besitzer. Eine Raw-Datei steht in genau einem raw_files: - diese Seite ist dafür verantwortlich, sie zusammengefasst zu halten. Beliebig viele Seiten dürfen sie per [^cite-id] zitieren; ein Zitat ist Wiederverwendung, raw_files: ist eine Wartungszuständigkeit. Bei zwei Anspruchstellern ist undefiniert, welche Seite bei einer Änderung der Raw-Datei nachgezogen werden muss - dann verrotten beide still
  • Source-Seiten machen Wissen bis zum ursprünglichen Rohmaterial rückverfolgbar
  • raw_files: enthält konkrete existierende Dateipfade, nie Verzeichnisse
  • Eine raw_files:-Liste jenseits von etwa 15 Einträgen zeigt an, dass der Schnitt zu grob war - die Quelle hätte per instructions/ingest-large-tree.md in mehrere Source-Seiten geteilt werden müssen