truthmark 1.2.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.de.md CHANGED
@@ -1,31 +1,68 @@
1
- # Truthmark ist die Wahrheitsschicht für KI-Softwareentwicklung.
1
+ # Truthmark
2
+
3
+ **Truthmark installiert Repository-Wahrheits-Workflows für KI-Softwareentwicklung.**
2
4
 
3
5
  [English](README.md) | Deutsch | [中文](README.zh.md) | [Español](README.es.md) | [Русский](README.ru.md)
4
6
 
5
- KI-Coding-Agenten können bereits gut Code schreiben. Womit sie weiterhin Schwierigkeiten haben: Produktabsicht, Architekturgrenzen und Zuständigkeiten im Repository zuverlässig aus veralteter Dokumentation, verstreuten Chats und flüchtigem Tool-Gedächtnis zu rekonstruieren.
6
- Truthmark löst das, indem es branch-lokale Repository-Wahrheit zu einer erstklassigen Laufzeitfläche für Agenten macht. Es installiert eine Git-native, branch-gebundene Wahrheitsschicht direkt im Repository, gibt Agenten explizite Routing- und Workflow-Grenzen und sorgt dafür, dass diese Wahrheit mit dem Code mitwandert, der tatsächlich ausgeliefert wird.
7
- Das ist kein besseres Prompt-Engineering. Es ist eine besser steuerbare Art, KI in einer echten Codebasis einzusetzen: weniger wiederholte Entscheidungen, weniger veraltete Dokumentation, sauberere Übergaben und KI-Coding-Sitzungen, die prüfbare Engineering-Aufzeichnungen hinterlassen, statt im Prompt-Verlauf oder in undurchsichtigen Tool-Zuständen zu verschwinden.
8
- Für Teams, die bereits wissen, dass Agenten Code erzeugen können, und jetzt wollen, dass das Repository selbst lesbar, prüfbar und steuerbar bleibt.
7
+ <img src="docs/assets/truthmark-banner.png" alt="Truthmark-Banner" width="100%" />
9
8
 
10
- ## Was Truthmark löst
9
+ KI-Coding-Agenten schreiben bereits schnell Code. Der teure Teil ist, die Repository-Wahrheit mit den tatsächlichen Änderungen im Gleichschritt zu halten.
10
+
11
+ Truthmark fügt diesem Ablauf eine Abschlusskontrolle als Workflow hinzu. Der normale Pfad ist einfach:
12
+
13
+ - Agent ändert funktionalen Code
14
+ - relevante Tests laufen
15
+ - der installierte Truth-Sync-Workflow aktualisiert zugeordnete Wahrheitsdokumente, bevor der Agent fertig ist
16
+ - Truth-Doc-Diff prüfen, wenn einer erzeugt wurde
17
+
18
+ Die meisten Tools bitten Teams darum, sich eine Gewohnheit anzueignen. Truthmark macht daraus Repository-Workflow-Infrastruktur.
19
+
20
+ Truthmark macht aus einem KI-Workflow Repository-Infrastruktur statt persönlichem Tooling. Es installiert eine Git-native, branch-gebundene Wahrheitsschicht im Repository, gibt Agenten explizites Routing und begrenzte Workflow-Flächen und hält diese Wahrheit in Git prüfbar, statt sie über Prompt-Verlauf, veraltete Dokumentation oder privaten Tool-Zustand zu verstreuen.
21
+
22
+ Das ist wichtig, weil der Workflow mit dem Branch lebt. Sobald ein Repository initialisiert ist, reisen Regeln, Routing und installierte Workflow-Flächen im Repository mit, sodass Zusammenarbeit und Übergaben weniger von der Rechnerkonfiguration einer einzelnen Person abhängen.
23
+
24
+ Für Teams, die bereits wissen, dass Agenten Code erzeugen können, beantwortet Truthmark das nächste Problem: wie das Repository selbst lesbar, prüfbar und steuerbar bleibt, wenn KI-gestützte Arbeit skaliert.
25
+
26
+ ## Visueller Überblick
27
+
28
+ <table>
29
+ <tr>
30
+ <td align="center" width="50%">
31
+ <img src="docs/assets/truthmark-features.png" alt="Truthmark-Funktionen" width="100%" />
32
+ <br><strong>Funktionen</strong><br>
33
+ Was Truthmark installiert und wie sich die Workflow-Fläche aufteilt.
34
+ </td>
35
+ <td align="center" width="50%">
36
+ <img src="docs/assets/truthmark-position.png" alt="Truthmark-Positionierung" width="100%" />
37
+ <br><strong>Positionierung</strong><br>
38
+ Wo Truthmark im Verhältnis zu Prompts, Memory und Spec-Workflows steht.
39
+ </td>
40
+ </tr>
41
+ <tr>
42
+ <td align="center" colspan="2">
43
+ <img src="docs/assets/truthmark-syncflow.png" alt="Truthmark-Sync-Ablauf" width="100%" />
44
+ <br><strong>Sync-Ablauf</strong><br>
45
+ Wie Truth Sync normale Codeänderungen vor einer Übergabe abschließt.
46
+ </td>
47
+ </tr>
48
+ </table>
49
+
50
+ ## Warum Teams es nutzen
11
51
 
12
- KI-Coding ist heute leicht zu starten, aber teuer zu beherrschen. Sobald Agenten schnell Code schreiben können, wird Repository-Wahrheit zur Steuerfläche.
13
- Dieses Fehlermuster zeigt sich vorhersehbar: Anforderungen bleiben im Chat, Architekturentscheidungen werden wiederholt, Agenten bearbeiten die falschen Bereiche, und Branches erben Kontext, den Reviewer nicht zuverlässig prüfen können. Der Code kommt vielleicht schnell voran, aber dem Repository wird schwerer zu vertrauen.
14
- Truthmark verändert das Arbeitsmodell:
52
+ Truthmark versucht nicht, Agenten klüger wirken zu lassen. Es soll KI-gestützte Repository-Änderungen vertrauenswürdiger machen.
15
53
 
16
- - Branch-lokale Wahrheit wandert mit dem Branch, statt in einem privaten Tool-Speicher zu liegen.
17
- - Git macht diese Wahrheit prüfbar, diffbar und im Team teilbar.
18
- - Dokumentation folgt dem Code, statt still in Fiktion abzudriften.
19
- - Routing bleibt in `docs/truthmark/areas.md` und delegierten untergeordneten Routendateien explizit, damit Agenten wissen, welche Dokumentation welchen Code verantwortet.
20
- - Aktive Produkt- und Architekturentscheidungen stehen in den kanonischen Dokumenten, die sie betreffen, nicht in zeitgestempelten Planungsprotokollen.
21
- - Local-first-Workflows vermeiden die Abhängigkeit von Daemon, Datenbank, Remote-Dienst oder MCP.
22
- - Das Modell funktioniert in Codebasen mit JavaScript, TypeScript, Go, Python, C# und Java.
54
+ - Installierte Truth-Sync-Läufe nach Codeänderungen machen Dokumentationspflege zu einer Workflow-Schutzschicht statt zu einer Teamgewohnheit.
55
+ - Branch-gebundene Wahrheit bewegt sich mit dem Code, sodass Reviewer aktuelle Wahrheit in normalen Git-Diffs prüfen können.
56
+ - Repository-native Workflow-Flächen machen Rollout leichter und Übergaben robuster als reine Pro-User-Konfiguration.
57
+ - Explizites Routing in `docs/truthmark/areas.md` und delegierten untergeordneten Routendateien gibt Agenten Zuständigkeitsgrenzen und sicherere Schreibpfade.
58
+ - Local-first-Betrieb vermeidet einen Daemon, eine Datenbank, einen Remote-Dienst oder eine MCP-Abhängigkeit.
59
+ - Das Routing-Modell ist sprachunabhängig, mit Coverage-Diagnostik für gängige JavaScript-, TypeScript-, Go-, Python-, C#- und Java-Codeflächen.
23
60
 
24
- Für Tech Leads liegt der Wert in Governance ohne Theater: Tests, Code Review und Ownership leisten weiterhin die eigentliche Arbeit; Truthmark macht den Kontext des Agenten dauerhaft, prüfbar und branch-gebunden.
61
+ Für Tech Leads liegt der Wert in Governance ohne Zusatzinfrastruktur: Tests, Code Review und Ownership leisten weiterhin die eigentliche Arbeit; Truthmark macht den Kontext des Agenten dauerhaft, prüfbar und branch-gebunden.
25
62
 
26
63
  ## Wo Truthmark hineinpasst
27
64
 
28
- Truthmark versucht nicht, jedes andere KI-Workflow-Tool zu ersetzen. Es sitzt in einer bestimmten Schicht des Stacks:
65
+ Truthmark ist keine allgemeine KI-Produktivitätssuite. Es besetzt eine bestimmte Schicht im Stack: branch-gebundene, prüfbare Repository-Wahrheit, die mit der Implementierung synchron bleibt.
29
66
 
30
67
  | Wenn du brauchst | Beste Wahl |
31
68
  | --------------------------------------------------------------------------- | ------------------------------------------- |
@@ -38,9 +75,9 @@ Der Punkt ist nicht, dass Prompts, Memory oder Specs nutzlos wären. Der Punkt i
38
75
 
39
76
  ## Inhalt
40
77
 
78
+ - [Warum Teams es nutzen](#warum-teams-es-nutzen)
41
79
  - [Was Truthmark löst](#was-truthmark-löst)
42
80
  - [Wo Truthmark hineinpasst](#wo-truthmark-hineinpasst)
43
- - [Workflow-Fläche](#workflow-fläche)
44
81
  - [Erste Schritte](#erste-schritte)
45
82
  - [Wie es läuft](#wie-es-läuft)
46
83
  - [Was es installiert](#was-es-installiert)
@@ -51,12 +88,13 @@ Der Punkt ist nicht, dass Prompts, Memory oder Specs nutzlos wären. Der Punkt i
51
88
  - [Nicht-Ziele](#nicht-ziele)
52
89
  - [Lizenz](#lizenz)
53
90
 
54
- ## Workflow-Fläche
91
+ ## Was Truthmark löst
55
92
 
56
93
  Truthmark macht Repository-Wahrheit zu einer expliziten Workflow-Fläche für Agenten:
57
94
 
58
- - `TRUTHMARK.md` definiert den branch-lokalen Workflow-Vertrag.
95
+ - `.truthmark/config.yml` definiert den festgeschriebenen Hierarchievertrag.
59
96
  - `docs/truthmark/areas.md` und delegierte untergeordnete Routendateien ordnen Codebereiche den Dokumenten zu, die sie verantworten.
97
+ - Truth Document erstellt oder repariert kanonische Wahrheitsdokumente für bereits implementiertes Verhalten, wenn keine Codeänderung nötig ist.
60
98
  - Truth Sync hält zugeordnete Wahrheitsdokumente bei funktionalen Änderungen synchron.
61
99
  - Truth Realize gibt doc-first Änderungen einen begrenzten Pfad für Code-Updates.
62
100
  - `truthmark check` validiert die daraus entstehenden Wahrheitsartefakte.
@@ -92,88 +130,145 @@ Prüfe `.truthmark/config.yml` vor `init`; es ist der in Git festgeschriebene Hi
92
130
 
93
131
  ```text
94
132
  .truthmark/config.yml
95
- TRUTHMARK.md
96
133
  docs/truthmark/areas.md
97
134
  docs/truthmark/areas/repository.md
98
- docs/features/README.md
99
- docs/features/repository/README.md
100
- docs/features/repository/overview.md
135
+ docs/templates/behavior-doc.md
136
+ docs/truth/README.md
137
+ docs/truth/repository/README.md
138
+ docs/truth/repository/overview.md
101
139
  AGENTS.md
102
140
  CLAUDE.md
141
+ GEMINI.md
103
142
  ```
104
143
 
105
144
  Unterstützte Plattformen sind `codex`, `opencode`, `claude-code`, `github-copilot` und `gemini-cli`. Die Standardkonfiguration enthält alle davon; entferne Plattformen, die du nicht nutzt, aus `.truthmark/config.yml`, bevor du `truthmark init` erneut ausführst.
106
- Die standardmäßig erzeugte Struktur verwendet `README.md`-Dateien von Features als Indizes und beginnt die Wahrheit über aktuelles Verhalten in begrenzten Blattdokumenten wie `docs/features/repository/overview.md`.
145
+ Die standardmäßig erzeugte Struktur verwendet Truth-`README.md`-Dateien als Indizes und beginnt die Wahrheit über aktuelles Verhalten in begrenzten Blattdokumenten wie `docs/truth/repository/overview.md`.
107
146
 
108
147
  Bestehende Repositories brauchen nach `init` meist einen Aufräumschritt: Führe den installierten Truth-Structure-Workflow aus, wenn die erzeugte `repository`-Route zu breit ist, Ownership mehrere Produkte oder Services umfasst oder Routendateien noch auf Platzhalterdokumente zeigen. Truth Structure teilt breite Routings auf, erstellt oder repariert erste kanonische Wahrheitsdokumente und gibt Truth Sync präzise Ziele, bevor funktionale Codearbeit beginnt. Codex, Claude Code und unterstützte Copilot-IDEs können ihn mit `/truthmark-structure` aufrufen; Hosts im OpenCode-Stil können `/skill truthmark-structure` verwenden.
109
148
 
110
149
  ## Wie es läuft
111
150
 
112
- Truthmark legt nicht fest, welcher Subagent Truth Sync ausführen soll. Der handelnde Agent und die Host-Umgebung entscheiden, ob delegiert oder der Workflow inline ausgeführt wird.
113
- Die meisten Nutzer sollten Truth Sync nicht direkt aufrufen müssen. Der normale Ablauf ist:
151
+ Truthmark ist am stärksten auf dem Standardpfad, nicht als Sammlung manueller Befehle. Der handelnde Agent und die Host-Umgebung entscheiden, ob delegiert oder der installierte Workflow inline ausgeführt wird.
152
+
153
+ ### Vorhandenes Verhalten ohne Doku
154
+
155
+ Nutze das, wenn die Implementierung bereits existiert, aber die kanonischen Wahrheitsdokumente fehlen oder schwach sind:
156
+
157
+ ```text
158
+ benutzer identifiziert ein implementiertes verhalten oder einen api-endpunkt
159
+ benutzer ruft truth document ausdrücklich auf
160
+ agent liest implementierung, tests, routing und vorhandene docs
161
+ agent schreibt nur truth docs und routing
162
+ truth-doc-diff prüfen
163
+ ```
164
+
165
+ Truth Document ist manuell und implementation-first: Code dient als Beleg, Wahrheitsdokumente werden erstellt oder repariert, und funktionaler Code darf nicht geändert werden. Codex, Claude Code und unterstützte Copilot-IDEs können es mit `/truthmark-document` aufrufen. Hosts im OpenCode-Stil können `/skill truthmark-document` verwenden.
166
+
167
+ ```text
168
+ /truthmark-document dokumentiere das implementierte session-timeout-verhalten unter docs/truth/authentication
169
+ ```
170
+
171
+ ### Normale Codeänderungen
172
+
173
+ Die meisten Nutzer sollten Truth Sync nicht direkt aufrufen müssen. Entscheidend ist, dass der installierte Agenten-Workflow Truth Sync als Abschlusskontrolle behandelt, wenn funktionaler Code geändert wurde. Der normale Ablauf ist:
114
174
 
115
175
  ```text
116
- Agent ändert funktionalen Code
117
- relevante Tests laufen
118
- Truth Sync wird vor dem Abschluss des Agenten ausgelöst
119
- Truth-Doc-Diff prüfen, falls einer erzeugt wurde
120
- Arbeit committen oder übergeben
176
+ agent ändert funktionalen code
177
+ relevante tests laufen
178
+ der installierte truth-sync-workflow läuft, bevor der agent fertig ist
179
+ truth-doc-diff prüfen, falls einer erzeugt wurde
180
+ arbeit committen oder übergeben
121
181
  ```
122
182
 
123
- Truth Sync ist code-first: Code führt, Wahrheitsdokumente folgen, und Truth Sync darf funktionalen Code nicht umschreiben. Seine Hauptaufgabe ist eine automatische Abschlusskontrolle, wenn funktionaler Code geändert wurde. Direkte Aufrufe sind vor allem für Fehlersuche, frühe Synchronisierung vor einer Übergabe oder bewusstes Ausführen des Workflows gedacht.
183
+ Truth Sync ist code-first: Code führt, Wahrheitsdokumente folgen, und Truth Sync darf funktionalen Code nicht umschreiben. Seine Hauptaufgabe ist, über den installierten Agenten-Workflow als Abschlusskontrolle zu laufen, wenn funktionaler Code geändert wurde. Direkte Aufrufe sind vor allem für Fehlersuche, frühe Synchronisierung vor einer Übergabe oder bewusstes Ausführen des Workflows gedacht.
184
+
124
185
  Codex, Claude Code und unterstützte Copilot-IDEs können es mit `/truthmark-sync` aufrufen. Hosts im OpenCode-Stil können `/skill truthmark-sync` verwenden.
125
- Nutze diesen Ablauf, wenn eine Produkt- oder Architekturentscheidung in der Dokumentation beginnt:
126
186
 
127
187
  ```text
128
- Benutzer bearbeitet Wahrheitsdokumente
129
- Benutzer ruft Truth Realize ausdrücklich auf
130
- Agent liest Wahrheitsdokumente und relevanten Code
131
- Agent aktualisiert nur Code
132
- relevante Tests laufen
133
- Arbeit committen oder übergeben
188
+ /truthmark-sync die repository-wahrheit jetzt vor der übergabe synchronisieren
189
+ ```
190
+
191
+ ### Doc-first-Änderungen
192
+
193
+ Nutze das, wenn eine Produkt- oder Architekturentscheidung in der Doku beginnt:
194
+
195
+ ```text
196
+ benutzer bearbeitet wahrheitsdokumente
197
+ benutzer ruft truth realize ausdrücklich auf
198
+ agent liest wahrheitsdokumente und relevanten code
199
+ agent aktualisiert nur code
200
+ relevante tests laufen
201
+ arbeit committen oder übergeben
134
202
  ```
135
203
 
136
204
  Truth Realize ist manuell und doc-first: Wahrheitsdokumente führen, Code folgt, und der Agent darf die Wahrheitsdokumente, die er realisiert, nicht bearbeiten.
205
+
137
206
  Codex, Claude Code und unterstützte Copilot-IDEs können es mit `/truthmark-realize` aufrufen. Hosts im OpenCode-Stil können `/skill truthmark-realize` verwenden.
138
207
 
208
+ ```text
209
+ /truthmark-realize docs/truth/authentication/session-timeout.md in code umsetzen
210
+ ```
211
+
139
212
  ## Was es installiert
140
213
 
141
- Truthmark hält die dauerhafte Workflow-Fläche klein:
214
+ Truthmark hält die dauerhafte Workflow-Fläche klein und repository-nativ. Nach `truthmark init` trägt das Repository selbst Routing, Regeln und installierte Workflow-Flächen, sodass Teams nicht nur auf die lokale Konfiguration einer einzelnen Person angewiesen sind.
142
215
 
143
- - `.truthmark/config.yml` für maschinenlesbare Konfiguration
144
- - `TRUTHMARK.md` für den branch-lokalen Workflow-Vertrag
216
+ - `.truthmark/config.yml` für den maschinenlesbaren, festgeschriebenen Hierarchievertrag
145
217
  - `docs/truthmark/areas.md` für den Root-Routenindex
146
218
  - `docs/truthmark/areas/**/*.md` für delegierte untergeordnete Routendateien
219
+ - `docs/templates/behavior-doc.md` sowie die weiteren typspezifischen Vorlagen unter `docs/templates/` für die editierbaren Truth-Doc-Standards der generierten Workflows
147
220
  - verwaltete Instruktionsblöcke für konfigurierte Plattformen wie `AGENTS.md`, `CLAUDE.md`, Copilot-Anweisungen und `GEMINI.md`
148
- - host-native Skills, Prompts oder Commands für Truth Structure, Truth Sync, Truth Realize und Truth Check
221
+ - host-native Skills, Prompts oder Commands für Truth Structure, Truth Document, Truth Sync, Truth Realize und Truth Check
149
222
 
150
223
  Die installierten Workflow-Flächen sind die Runtime:
151
224
 
152
225
  - Truth Structure erstellt oder repariert Area-Routing und erste Wahrheitsdokumente.
226
+ - Truth Document erstellt oder repariert Wahrheitsdokumente für bereits implementiertes Verhalten.
153
227
  - Truth Sync hält zugeordnete Wahrheitsdokumente bei funktionalen Änderungen synchron.
154
228
  - Truth Realize aktualisiert Code so, dass er zu den Wahrheitsdokumenten passt.
155
229
  - Truth Check auditiert die Gesundheit der Repository-Wahrheit.
156
230
 
157
- `README.md`-Dateien von Features sind Indizes. Truth Sync soll begrenzte Blattdokumente für aktuelles Verhalten lesen und aktualisieren.
231
+ `README.md`-Dateien von Features sind Indizes. Truth Sync soll begrenzte Blattdokumente für aktuelles Verhalten lesen und aktualisieren. Generierte Workflow-Flächen bewahren die Autorität der Repository-Regeln, während sie Implementierungscode und kanonische Wahrheitsdokumente als Belege für aktuelles Verhalten behandeln.
158
232
 
159
233
  Generierte Flächen werden von Truthmark verwaltet, enthalten einen Versionsmarker und können mit `truthmark init` aktualisiert werden.
160
234
 
161
235
  ## Befehle
162
236
 
163
- Truthmark V1 hält die CLI absichtlich klein. In nachgelagerten Repositories erzeugt `truthmark config` den in Git festgeschriebenen Hierarchievertrag, `truthmark init` installiert und aktualisiert Workflow-Flächen aus dieser geprüften Konfiguration, und `truthmark check` validiert Wahrheitsartefakte für manuelle Audits, CI oder Fehlersuche.
237
+ Truthmark V1 hält die CLI fokussiert, weil der laufende Workflow in den installierten Agenten-Flächen leben soll und nicht in einer langen Liste täglicher manueller Befehle. In nachgelagerten Repositories erzeugt `truthmark config` den in Git festgeschriebenen Hierarchievertrag, `truthmark init` installiert und aktualisiert Workflow-Flächen aus dieser geprüften Konfiguration, `truthmark check` validiert Wahrheitsartefakte für manuelle Audits, CI oder Fehlersuche, und die Repository-Intelligence-Befehle erzeugen abgeleitete Prüfarbeitsstände, wenn lokale Werkzeuge verfügbar sind.
164
238
 
165
239
  ```bash
166
240
  truthmark config
167
241
  truthmark init
168
242
  truthmark check
243
+ truthmark index
244
+ truthmark impact --base main
245
+ truthmark context --workflow truth-sync --base main
169
246
  truthmark config --json
170
247
  truthmark check --json
248
+ truthmark index --json
249
+ truthmark impact --base main --json
250
+ truthmark context --workflow truth-sync --base main --json
171
251
  ```
172
252
 
173
253
  `config` schreibt nur `.truthmark/config.yml`, außer `--stdout` wird verwendet.
254
+
174
255
  `init` benötigt `.truthmark/config.yml` und installiert oder aktualisiert anschließend die lokalen Workflow-Dateien.
256
+
175
257
  `check` validiert Konfiguration, Autorität, Routing, entscheidungstragende Dokumente, Frontmatter, interne Links, Branch-Scope und Coverage-Diagnostik.
176
- Truth Structure, Truth Sync, Truth Realize und Truth Check sind installierte Agenten-Workflows, keine täglichen Top-Level-CLI-Befehle.
258
+
259
+ `index` baut RepoIndex- und RouteMap-JSON für den aktiven Checkout.
260
+
261
+ `impact --base <ref>` ordnet geänderte Dateien den gerouteten Truth-Dokumenten, Routen, nahen Tests und öffentlichen Symbolen zu.
262
+
263
+ `context --workflow <workflow> [--base <ref>]` erzeugt ein begrenztes ContextPack für Truth Sync, Truth Document oder Truth Realize. `--format markdown` rendert eine menschenlesbare Fassung.
264
+
265
+ Truth Structure, Truth Document, Truth Sync, Truth Realize und Truth Check sind installierte Agenten-Workflows, keine täglichen Top-Level-CLI-Befehle.
266
+
267
+ Sie laufen über die konfigurierten Agenten-Host-Flächen, zum Beispiel Codex/Claude/Copilot `/truthmark-*`, OpenCode `/skill truthmark-*` oder Gemini `/truthmark:*`.
268
+
269
+ ```text
270
+ /truthmark-check routing und truth-abdeckung vor der review prüfen
271
+ ```
177
272
 
178
273
  ## Warum es existiert
179
274
 
@@ -191,16 +286,21 @@ Es geht davon aus, dass ernsthafte Teams Folgendes brauchen:
191
286
 
192
287
  ## Projektstatus
193
288
 
194
- Truthmark ist kein Memory-Server und kein MCP-Server. Es ist eine Repository-Praxis, verpackt als kleiner CLI-Installer plus agent-native Workflow-Flächen.
289
+ Truthmark ist kein Memory-Server und kein MCP-Server. Es ist eine Repository-Praxis, verpackt als kleiner CLI-Installer plus agent-native Workflow-Flächen, die KI-Workflow-Regeln in Repository-Infrastruktur verwandeln.
290
+
195
291
  V1 bietet derzeit:
196
292
 
197
293
  - `truthmark config`
198
294
  - `truthmark init`
199
295
  - `truthmark check`
296
+ - `truthmark index`
297
+ - `truthmark impact`
298
+ - `truthmark context`
200
299
  - verwaltete `AGENTS.md`-Workflow-Anweisungen
201
- - generierte Skill-Flächen für Truth Structure, Truth Sync, Truth Realize und Truth Check für konfigurierte Agenten-Hosts
300
+ - generierte Truth Structure-, Truth Document-, Truth Sync-, Truth Realize- und Truth Check-Skill-Flächen für konfigurierte Agenten-Hosts
202
301
  - Branch-Scope-Metadaten
203
- - Diagnostik für Konfiguration, Autorität, Routing, Entscheidungsstruktur, Frontmatter, Links und polyglotte Abdeckung
302
+ - Diagnostik für Konfiguration, Autorität, Routing, Entscheidungsstruktur, Frontmatter, Links, Freshness und polyglotte Abdeckung
303
+ - abgeleitete RepoIndex-, RouteMap-, ImpactSet- und ContextPack-Artefakte für schnellere lokale Prüfung, wenn die CLI verfügbar ist
204
304
 
205
305
  ## Dokumentation
206
306
 
@@ -208,10 +308,10 @@ Die Root-README ist für Menschen gedacht, die das Paket evaluieren und ausprobi
208
308
 
209
309
  - [Dokumentationsindex](docs/README.md)
210
310
  - [Architekturüberblick](docs/architecture/overview.md)
211
- - [API- und CLI-Verträge](docs/features/contracts.md)
212
- - [Init- und Scaffold-Verhalten](docs/features/init-and-scaffold.md)
213
- - [Check-Diagnostik](docs/features/check-diagnostics.md)
214
- - [Installierte Workflows](docs/features/installed-workflows.md)
311
+ - [API- und CLI-Verträge](docs/truth/contracts.md)
312
+ - [Init- und Scaffold-Verhalten](docs/truth/init-and-scaffold.md)
313
+ - [Check-Diagnostik](docs/truth/check-diagnostics.md)
314
+ - [Installierte Workflows](docs/truth/workflows/overview.md)
215
315
  - [Leitfaden zur Pflege von Repository-Wahrheit](docs/standards/maintaining-repository-truth.md)
216
316
 
217
317
  Aktuelles Verhalten gehört in den oben genannten kanonischen Dokumentationsbaum.