---
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]
layout:
  architecture: {dir: architectures, title: Architekturen}
  pattern: {dir: patterns, title: Muster}
  protocol: {dir: protocols, title: Protokolle}
  workflow: {dir: workflows, title: Abläufe}
  decision: {dir: decisions, title: Entscheidungen}
  problem: {dir: problems, title: Problemstellungen}
---

# 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` § "Titles are identifiers", `kb/CONVENTIONS.md` §§ "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 die beiden toolgeführten
Abschnitte für Beziehungen und Querverweise; wie sie heißen, entscheidet die Instanz in
`kb/CONVENTIONS.md` (`sections:`).

---

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