Chemenu 2.1.0 - deterministischer Wissenskompiler
Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
This commit is contained in:
@@ -0,0 +1,102 @@
|
||||
---
|
||||
type: types/type-spec.md
|
||||
name: concept
|
||||
description: Basistyp für Concept-Seiten - Architekturen, Muster, Protokolle, Abläufe, Entscheidungen oder Problemstellungen
|
||||
schema: types/concept.schema.yaml
|
||||
subtype_field: concept_type
|
||||
base_dir: concepts
|
||||
page_ref_fields: [related, sources]
|
||||
---
|
||||
|
||||
# Concept
|
||||
|
||||
`concept` ist der Typ für abstrakte Ideen, Methodiken, Muster und Architekturentscheidungen. Concepts liefern die theoretische und methodische Grundlage, die Entities umsetzen oder befolgen.
|
||||
|
||||
## Wann zu verwenden
|
||||
|
||||
- Dokumentation eines Architekturmusters oder Entwurfsansatzes
|
||||
- Erläuterung eines Entwurfsmusters oder einer Programmiermethodik
|
||||
- Beschreibung eines Kommunikationsprotokolls oder Standards
|
||||
- Festhalten eines Ablaufs oder Prozesses, der über Projekte hinweg wiederkehrt
|
||||
- Dokumentation einer Architekturentscheidung (ADR) oder Entwurfsentscheidung
|
||||
- Analyse eines wiederkehrenden Problems und seiner Lösungen
|
||||
|
||||
## Wann NICHT zu verwenden
|
||||
|
||||
- Für konkrete Dinge wie Projekte, Systeme oder Werkzeuge (dann `entity`)
|
||||
- Für Quelldokumente oder eingelesenes Material (dann `source`)
|
||||
- Für vergleichende Analysen konkreter Gegenstände (dann `comparison`)
|
||||
|
||||
## Frontmatter
|
||||
|
||||
| Feld | Pflicht | Verwendung |
|
||||
|---|---:|---|
|
||||
| `type` | Ja | `types/concept.md` |
|
||||
| `concept_type` | Ja | Eines von: architecture, pattern, protocol, workflow, decision, problem |
|
||||
| `tags` | Nein | Navigations-Tags zur Kategorisierung |
|
||||
| `created` | Ja | Erstellungsdatum (YYYY-MM-DD) |
|
||||
| `modified` | Ja | Datum der letzten Änderung (YYYY-MM-DD) |
|
||||
| `related` | Nein | Titel verwandter Concepts und Entities |
|
||||
| `sources` | Nein | Titel der Source-Seiten, die die Aussagen dieser Seite stützen |
|
||||
| `confidence` | Nein | Abgeleitete Konfidenz (0.0-1.0), neu berechnet von `wikitool confidence decay` |
|
||||
| `confidence_base` | Nein | Unverfallene Konfidenz zum Zeitpunkt der letzten Bestätigung - bei einer Neubewertung dieses Feld ändern, nicht `confidence` |
|
||||
| `provenance` | Ja | sourced, general oder mixed |
|
||||
| `summary` | Ja | Einzeiler für `kb/index.md` |
|
||||
|
||||
## Autorenanweisungen
|
||||
|
||||
- Der Titel ist der kanonische Name des Concepts und folgt der etablierten Fachbezeichnung, nicht der KB-Sprache (`kb/CONTRACT.md`, Abschnitte "Naming" und "Language")
|
||||
- Mit einer klaren Definition beginnen: was das Concept ist
|
||||
- Beispiele geben, wo sie das Verständnis tragen
|
||||
- Auf Entities verlinken, die das Concept umsetzen oder verwenden
|
||||
- Bei `provenance: sourced` oder `mixed` harte Fakten inline mit einer `[^cite-id]`-Fußnote belegen -
|
||||
`tools/wikitool cite add --page "<Title>" --source "Source - X"` erzeugt Id und Definition
|
||||
- Wikipedia-Tonfall: sachlich, neutral, keine Werbesprache
|
||||
|
||||
## Template
|
||||
|
||||
```markdown
|
||||
# {name}
|
||||
|
||||
**Typ:** {concept_type|capitalize}
|
||||
|
||||
## Definition
|
||||
|
||||
TODO: Klare Definition dessen, was dieses Concept ist.
|
||||
|
||||
## Kernpunkte
|
||||
|
||||
- TODO: Kernpunkt 1
|
||||
- TODO: Kernpunkt 2
|
||||
- TODO: Kernpunkt 3
|
||||
|
||||
## Beispiele
|
||||
|
||||
- [[Entity 1]] - kurze Beschreibung
|
||||
- [[Entity 2]] - kurze Beschreibung
|
||||
|
||||
## Wann zu verwenden
|
||||
|
||||
TODO: Bedingungen und Kontexte, in denen dieses Concept greift
|
||||
|
||||
## Wann NICHT zu verwenden
|
||||
|
||||
TODO: Anti-Muster, Warnungen oder Situationen, in denen es fehl am Platz ist
|
||||
|
||||
## Verwandte Concepts
|
||||
|
||||
- [[Related Concept 1]]
|
||||
- [[Related Concept 2]]
|
||||
```
|
||||
|
||||
Der Wert hinter `**Typ:**` bleibt der englische Enum-Wert - danach filtert `search --field`.
|
||||
Fügt `wikitool xref` eine Beziehung hinzu, entstehen zusätzlich `## Beziehungen` und
|
||||
`## Siehe auch`; deren Namen stehen in `tools/chemenu/sections.py`.
|
||||
|
||||
---
|
||||
|
||||
Ergänzende Hinweise:
|
||||
|
||||
- Concept-Seiten tragen den theoretischen Unterbau des Wikis
|
||||
- Jeder Concept-Typ steht für eine andere Kategorie abstrakten Wissens
|
||||
- Concepts sollten von den Entities aus verlinkt sein, die sie umsetzen oder verwenden
|
||||
Reference in New Issue
Block a user