---
type: types/type-spec.md
name: entity
description: Basistyp für Entity-Seiten - Projekte, Systeme, Werkzeuge, Technologien oder Personen
schema: types/entity.schema.yaml
subtype_field: entity_type
base_dir: entities
page_ref_fields: [related, sources]
layout:
  project: {dir: projects, title: Projekte}
  system: {dir: systems, title: Systeme}
  tool: {dir: tools, title: Werkzeuge}
  technology: {dir: technologies, title: Technologien}
  person: {dir: people, title: Personen}
---

# Entity

`entity` ist der Typ für konkrete Dinge: Projekte, Systeme, Werkzeuge, Technologien oder Personen. Entities sind die primären Bausteine des Wissensgraphen.

## Wann zu verwenden

- Darstellung eines Softwareprojekts, einer Initiative oder eines Arbeitsvorhabens
- Dokumentation eines betriebenen Systems, Dienstes oder einer Infrastrukturkomponente
- Beschreibung eines CLI-Werkzeugs, Hilfsprogramms oder einer Programmbibliothek
- Festhalten von Informationen zu einer Sprache, einem Framework oder einem Protokoll
- Dokumentation einer Person, eines Teams oder einer Organisation

## Wann NICHT zu verwenden

- Für abstrakte Konzepte, Muster oder Methodiken (dann `concept`)
- Für Quelldokumente oder eingelesenes Material (dann `source`)
- Für vergleichende Analysen (dann `comparison`)

## Frontmatter

| Feld | Pflicht | Verwendung |
|---|---:|---|
| `type` | Ja | `types/entity.md` |
| `entity_type` | Ja | Eines von: project, system, tool, technology, person |
| `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 Seiten (Entities, Concepts, Sources) |
| `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 der Entity und folgt der etablierten Bezeichnung des Gegenstands, nicht der KB-Sprache (`kb/CONTRACT.md` § "Titles are identifiers", `kb/CONVENTIONS.md` §§ "Naming" und "Language")
- Die Hauptbeschreibung steht weit oben
- Auf verwandte Entities und Concepts verlinken, wo Beziehungen bestehen
- 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:** {entity_type|capitalize}

## Beschreibung

TODO: 1-2 Absätze dazu, was diese Entity ist und wozu sie dient.

## Kerndaten

- **Zweck:** TODO
- **Status:** aktiv, abgelöst, in Planung usw.
- **Version:** TODO (falls zutreffend)
- **Sprache/Technik:** TODO (falls zutreffend)
- **Verantwortlich:** TODO (falls zutreffend)
- **Repository:** TODO (falls zutreffend)

## Details

TODO: Ausführliche Informationen, nach sinnvollen Abschnitten gegliedert

## Historie

- [{today}] - Page created via wikitool
```

Der Beziehungsabschnitt steht bewusst **nicht** im Template: er ist eine generierte Region, die
`wikitool xref` beim ersten Kanteneintrag zwischen Markern anlegt und aus `related:` neu
rendert. Ein Autor schreibt dort nie hinein. Der Wert hinter `**Typ:**` bleibt der englische
Enum-Wert - danach filtert `search --field`.

---

Ergänzende Hinweise:

- Entity-Seiten bilden den konkreten Bestand der Wissensbasis
- Jeder Entity-Typ (project, system, tool usw.) ist eine Ausprägung dieses Basistyps
- Die Beziehungen zwischen Entities tragen die Vernetzung des Wissensgraphen