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 +155 -55
- package/README.es.md +149 -49
- package/README.md +125 -43
- package/README.ru.md +148 -48
- package/README.zh.md +146 -46
- package/dist/main.js +2974 -863
- package/dist/main.js.map +1 -1
- package/package.json +2 -2
package/README.de.md
CHANGED
|
@@ -1,31 +1,68 @@
|
|
|
1
|
-
# Truthmark
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
- Routing
|
|
20
|
-
-
|
|
21
|
-
-
|
|
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
|
|
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
|
|
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
|
-
##
|
|
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
|
-
-
|
|
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/
|
|
99
|
-
docs/
|
|
100
|
-
docs/
|
|
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
|
|
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
|
|
113
|
-
|
|
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
|
-
|
|
117
|
-
relevante
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
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
|
|
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
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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/
|
|
212
|
-
- [Init- und Scaffold-Verhalten](docs/
|
|
213
|
-
- [Check-Diagnostik](docs/
|
|
214
|
-
- [Installierte Workflows](docs/
|
|
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.
|