wdi-method 0.6.28 → 0.6.30

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/CHANGELOG.md CHANGED
@@ -10,6 +10,43 @@ version contains every fix below it.
10
10
 
11
11
  ---
12
12
 
13
+ ## [0.6.30] - 2026-09-27
14
+
15
+ A patch. No behaviour changes.
16
+
17
+ ### Changed: text
18
+
19
+ - **README: removed the contributor-only notice.** The "this repository is public and generic"
20
+ callout in `README.md` and all nine translations was a rule for contributors and agents, not
21
+ information for a reader of the package — it already lives in `CONTRIBUTING.md` and now also in
22
+ `AGENTS.md`. Deleted from every README.
23
+ - **The npm package now ships only the English README (translations stay on GitHub).** npm always
24
+ packs any root file whose name starts with `readme`, regardless of `package.json`'s `files` list —
25
+ which is how a translation (`README.zh-CN.md`) ended up as the registry's `readmeFilename` instead
26
+ of `README.md`. The nine translations moved to `translations/` (a plain subdirectory, not swept by
27
+ that rule) and their cross-links were updated; `README.md`'s language row now points there. npm
28
+ resolves the relative links on npmjs.com against the `repository` field, so they still open the
29
+ right file on GitHub.
30
+
31
+ **What a repo that already has the method installed does about it.** Nothing beyond
32
+ `npx wdi-method@latest update --yes` — this package's own README and npm packaging, not anything the
33
+ installer writes into a consuming repo.
34
+
35
+ ---
36
+
37
+ ## [0.6.29] - 2026-09-27
38
+
39
+ A patch. No behaviour changes.
40
+
41
+ ### Changed: text
42
+
43
+ - Public documentation links now point to wiradelta.com.
44
+
45
+ **What a repo that already has the method installed does about it.** Nothing beyond
46
+ `npx wdi-method@latest update --yes` — this is a docs-link fix with no effect on generated files.
47
+
48
+ ---
49
+
13
50
  ## [0.6.28] - 2026-09-24
14
51
 
15
52
  A patch, but **read the reviewer change below before you update**: it changes what the daily autopilot
package/README.md CHANGED
@@ -2,14 +2,12 @@
2
2
 
3
3
  > A review layer on top of BMad: documents a human reads to check technical decisions before code is written, sized to what the change actually deserves.
4
4
 
5
- [English](README.md) | [Bahasa Indonesia](README.id.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Português (Brasil)](README.pt-BR.md) | [Русский](README.ru.md)
6
- [Website](https://wiradelta.id/wdi-method/docs/) | [Changelog](CHANGELOG.md) | [Contributing](CONTRIBUTING.md) | [License](LICENSE) | [Security](SECURITY.md) | [Privacy](PRIVACY.md)
5
+ [English](README.md) | [Bahasa Indonesia](translations/README.id.md) | [简体中文](translations/README.zh-CN.md) | [日本語](translations/README.ja.md) | [한국어](translations/README.ko.md) | [Español](translations/README.es.md) | [Deutsch](translations/README.de.md) | [Français](translations/README.fr.md) | [Português (Brasil)](translations/README.pt-BR.md) | [Русский](translations/README.ru.md)
6
+ [Website](https://wiradelta.com/wdi-method/docs/) | [Changelog](CHANGELOG.md) | [Contributing](CONTRIBUTING.md) | [License](LICENSE) | [Security](SECURITY.md) | [Privacy](PRIVACY.md)
7
7
 
8
8
  ---
9
9
 
10
- [BMad](https://github.com/bmad-code-org/BMAD-METHOD) writes documents for AI agents. WDI Method adds documents that many roles already read: use cases, C4 diagrams, API and database lists, and design documents. It wraps BMad without replacing it: each WDI skill hands the writing to a BMad skill, then checks the result against the method's guides.
11
-
12
- > This repository is **public and generic**. It MUST NOT carry a client name, a commercial product name, or a link to a private repository. Product identity lives entirely in the repository that installs it.
10
+ [BMad](https://github.com/bmad-code-org/BMAD-METHOD) writes documents for AI agents. WDI Method adds documents that many roles already read: use cases, C4 diagrams, API and database lists, and design documents. It wraps BMad without replacing it: the brief, PRD, UX, and architecture skills (`wdi-problem`, `wdi-product`, `wdi-ux`, and `wdi-blueprint` for the spine) hand the writing to a BMad skill, then check the result against the method's guides.
13
11
 
14
12
  ---
15
13
 
@@ -160,7 +158,8 @@ A runner named as a reviewer MUST be read-only. The read-only flag per CLI: `cla
160
158
  WDI Method installs 22 skills: 7 gate skills, 5 for the daily tier (including `wdi-autopilot`), and 10 you run any time.
161
159
 
162
160
  How a skill starts:
163
- - **You type it**: the four daily tier skills, `wdi-build`, and `wdi-explain-to-me` (they carry `disable-model-invocation: true`).
161
+ - **You type it**: the four daily tier skills and `wdi-explain-to-me` (they carry `disable-model-invocation: true`).
162
+ - **You type it, or `wdi-autopilot` runs it under an accepted mandate**: `wdi-build`. It carries no `disable-model-invocation` flag, because `wdi-autopilot` has to invoke it; the rule that agents do not start it on their own is in the Method policy the installer writes into `CLAUDE.md` and `AGENTS.md`.
164
163
  - **You type it, or the agent names it and waits for your go-ahead**: the other skills.
165
164
  - **The agent may run it on its own (read-only)**: `wdi-help`.
166
165
  - **Fired by `/loop` under an accepted mandate**: `wdi-autopilot`. Under a mandate, `wdi-autopilot` also runs the other skills.
@@ -174,7 +173,7 @@ How a skill starts:
174
173
  | `/wdi-ux` | Optional, with G2. Runs BMad's UX skill and files the design results where they belong. Never writes UX content itself. | You type it, or the agent names it |
175
174
  | `/wdi-blueprint` | G3, once per product. The whole-product picture: use cases, actors, domain model, business rules, glossary, the architecture spine, C4, and the API, table, and screen inventories. | You type it, or the agent names it |
176
175
  | `/wdi-component` | G4. The depth of one component, as deep as its `mode` and no deeper. Skipped at `mode: catalog`. | You type it, or the agent names it |
177
- | `/wdi-build` | G5. One spec from open to closed: you run `to-spec` and `to-tickets`, each ticket goes to a green PR, then the spec closes. It never merges. | You type it |
176
+ | `/wdi-build` | G5. One spec from open to closed: you run `to-spec` and `to-tickets`, each ticket goes to a green PR, then the spec closes. It never merges. | You type it, or `wdi-autopilot` runs it |
178
177
  | **Daily tier** | | |
179
178
  | `/wdi-daily-what-to-build` | Turns hand-testing notes into a reviewed spec or ticket for a later autopilot run. Stops before code, commit, or push. | You type it |
180
179
  | `/wdi-daily-autopilot` | Checks for an accepted mandate (runs the preflight if there is none), resolves reviewers from local config, and starts the loop, every 10 minutes by default. | You type it |
@@ -255,4 +254,4 @@ to take; the name is not.
255
254
 
256
255
  ---
257
256
 
258
- We use the same method on client projects. [Contact Wira Delta Indonesia](https://wiradelta.id/#contact).
257
+ We use the same method on client projects. [Contact Wira Delta Indonesia](https://wiradelta.com/studio/#contact).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "wdi-method",
3
- "version": "0.6.28",
3
+ "version": "0.6.30",
4
4
  "description": "The review layer for AI coding agents: human review gates that check technical decisions before Claude Code, Cursor, or Codex write the code. Wraps BMad.",
5
5
  "keywords": [
6
6
  "bmad",
@@ -30,15 +30,6 @@
30
30
  "kit-overlay/",
31
31
  "scaffold/",
32
32
  "README.md",
33
- "README.id.md",
34
- "README.zh-CN.md",
35
- "README.ja.md",
36
- "README.ko.md",
37
- "README.es.md",
38
- "README.de.md",
39
- "README.fr.md",
40
- "README.pt-BR.md",
41
- "README.ru.md",
42
33
  "CHANGELOG.md",
43
34
  "LICENSE",
44
35
  "NOTICE",
package/README.de.md DELETED
@@ -1,262 +0,0 @@
1
- # WDI Method
2
-
3
- > Eine Überprüfungsschicht auf BMad: Dokumente, die ein Mensch liest, um technische Entscheidungen zu prüfen, bevor Code geschrieben wird, bemessen an dem, was die Änderung tatsächlich verdient.
4
-
5
- [English](README.md) | [Bahasa Indonesia](README.id.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Português (Brasil)](README.pt-BR.md) | [Русский](README.ru.md)
6
- [Website](https://wiradelta.id/wdi-method/docs/) | [Changelog](CHANGELOG.md) | [Contributing](CONTRIBUTING.md) | [License](LICENSE) | [Security](SECURITY.md) | [Privacy](PRIVACY.md)
7
-
8
- ---
9
-
10
- > **Übersetzungshinweis:** Diese Datei ist eine Übersetzung von [README.md](README.md) und dient ausschließlich Informationszwecken. Bei Widersprüchen oder Auslegungsunterschieden ist die offizielle englische Originalfassung (`README.md`) maßgeblich. Alle tiefergehenden technischen Dokumentationen und rechtlichen Bedingungen werden auf Englisch geführt.
11
-
12
- [BMad](https://github.com/bmad-code-org/BMAD-METHOD) schreibt Dokumente für KI-Agenten. WDI Method fügt Dokumente hinzu, die viele Rollen bereits lesen: Use Cases, C4-Diagramme, API- und Datenbanklisten sowie Designdokumente. Es umschließt BMad, ohne es zu ersetzen: Jeder WDI-Skill übergibt das Schreiben an einen BMad-Skill und prüft das Ergebnis anschließend anhand der Leitfäden der Methode.
13
-
14
- > Dieses Repository ist **öffentlich und generisch**. Es DARF KEINEN Kundennamen, keinen kommerziellen Produktnamen und keinen Link zu einem privaten Repository enthalten. Die Produktidentität liegt vollständig in dem Repository, das es installiert.
15
-
16
- ---
17
-
18
- ## KI-gestützte Entwicklung (AiDD) vs. Vibe Coding
19
-
20
- Auch Vibe Coding nutzt Spezifikationen, aber nicht konsequent: Jede Prompt-Sitzung kann anders ausfallen, die Dokumente sind unstrukturiert, und der Prozess wird nicht systematisch gehalten. Das Ergebnis ist eine deutlich geringere Effizienz und Wirksamkeit und ein reales Risiko, technische Schulden anzuhäufen. Deshalb braucht es ein Framework.
21
-
22
- In WDI Method läuft AI-Driven Development (AiDD) in einer festen Reihenfolge: Versprechen, registriert als FR und Use Cases, dann die Gates, dann die Spezifikation, mit `to-spec` und `to-tickets` in Tickets geschnitten, dann jedes Ticket test-first gebaut, dann ein PR, den der Owner prüft und merged.
23
-
24
- Drei Schichten erledigen die Arbeit:
25
-
26
- | Schicht | Wer | Was sie tut |
27
- |---|---|---|
28
- | 1. Dokumente für Agenten | [BMad](https://github.com/bmad-code-org/BMAD-METHOD) | Schreibt den Product Brief, das PRD, die UX und das Architektur-Rückgrat, jeweils über einen BMad-Skill |
29
- | 2. Überprüfungsschicht | WDI Method | Umschließt diese Skills, fügt die Dokumente hinzu, die andere Rollen lesen, führt fünf menschliche Gates durch, verknüpft Ziel → FR → UC → Ticket → Test und prüft das Korpus auf Drift |
30
- | 3. Tickets und Code | Engines ([mattpocock/skills](https://github.com/mattpocock/skills)) | `to-spec` und `to-tickets` schneiden die Spezifikation in vertikale Tickets; `implement` baut jedes davon test-first |
31
-
32
- ### Dokumente folgen dem Code (Documents Follow Code)
33
-
34
- Ein Dokument, das hinter dem Code zurückliegt, ist in seinem erwarteten Zustand und kein Fehler. Wo der Owner den Code einem Dokument vorgezogen hat, wird das Dokument korrigiert. Ein Dokument, das dem Code voraus ist, etwa eine noch nicht gebaute Spezifikation, ist ebenfalls normal.
35
-
36
- ---
37
-
38
- ## Installation in 3 Schritten
39
-
40
- ### Voraussetzungen
41
-
42
- - Node.js 20 oder neuer.
43
- - Git.
44
- - [uv](https://docs.astral.sh/uv/), das die Python-3.11+-Validatoren der Methode ausführt.
45
- - Eine Agentenplattform: Claude Code, Cursor, Codex und andere Agentenplattformen.
46
-
47
- Führen Sie die drei Schritte der Reihe nach aus. Der Installer bricht ab, wenn Schritt 1 oder Schritt 2 nicht erledigt ist. Alle Abfragen bieten Standardwerte an; mit <kbd>Enter</kbd> übernehmen Sie sie.
48
-
49
- ### Schritt 1: BMad Method installieren
50
- ```bash
51
- cd /path/to/your/product-repo
52
- npx bmad-method install
53
- ```
54
-
55
- ### Schritt 2: Die sechs Engines hinzufügen
56
- Installieren Sie die Engines in Ihr Repository (wählen Sie "copy" oder "symlink"):
57
- ```bash
58
- npx skills@latest add mattpocock/skills
59
- ```
60
- *Wählen Sie alle sechs Engines, die die Methode ansteuert:* `to-spec`, `to-tickets`, `implement`, `tdd`, `code-review` und `domain-modeling`.
61
-
62
- > **Warum das Claude-Code-Plugin nicht ausreicht:** Drei der sechs Engines (`to-spec`, `to-tickets`, `implement`) werden mit `disable-model-invocation: true` ausgeliefert. Bei jeder Installation und jedem Update entfernt WDI Method diese Zeile aus den Kopien in Ihrem Repository, damit `wdi-build` und `wdi-autopilot` sie ausführen können. Ein Plugin auf Benutzerebene kann es nicht bearbeiten, daher bricht der Installer ab, bis die Engines im Repository liegen. `--skip-engines-check` überspringt diese Prüfung.
63
-
64
- ### Schritt 3: WDI Method installieren
65
- Startet den interaktiven Installer und legt die Skills dort ab, wo jede Ihrer Agentenplattformen sie liest:
66
- ```bash
67
- npx wdi-method
68
- ```
69
- *(Nicht interaktiv: `npx wdi-method install --yes --agents claude-code --product "Your Product"`)*
70
-
71
- > **Was der Installer an BMad ändert:** Der Installer schaltet außerdem den Modellaufruf für 13 Build- und Sprint-Skills von BMad ab, die die Engines ersetzen, und fügt passende Deny-Regeln in `.claude/settings.json` ein. Sie können sie weiterhin ausführen, indem Sie den Befehl eintippen.
72
-
73
- ### Ihr erster Befehl: `/wdi-help`
74
- Führen Sie in Ihrem Coding-Agenten aus:
75
- ```text
76
- /wdi-help
77
- ```
78
- `wdi-help` liest `.control/registry/` und nennt Ihnen das Gate, an dem Ihr Projekt steht, die offenen Spezifikationen und den nächsten Skill, ohne aus dem Gesprächsverlauf zu raten.
79
-
80
- ---
81
-
82
- ## Drei Workflow-Optionen
83
-
84
- WDI Method bemisst seinen Aufwand an Umfang und Risiko der Aufgabe.
85
-
86
- ### Option A: Geführter Lieferpfad (G1 bis G5)
87
- Für neue Produkte, größere Initiativen und Architekturänderungen. Sie starten den Skill jedes Gates; der Agent nennt den nächsten und wartet.
88
-
89
- **Eine Entscheidung pro Gate.** Jedes Gate entscheidet eine Sache. Bei G1 bis G4 lesen Sie eine gerenderte Seite; bei G5 lesen Sie die RTM-Zeilen der Spezifikation. Sie beantworten eine kurze Checkliste, und ein einziges "Nein" auf eine markierte Frage hält das Gate an.
90
-
91
- | Gate | Entscheidet | Skill | Was Sie lesen | Entscheidung des Owners |
92
- |---|---|---|---|---|
93
- | **G1 Problem** | Was das Problem ist, wessen Problem es ist und warum es Arbeit verdient | `/wdi-problem` | `.what-rendered/_product-brief/brief.md` | Die Problemstellung genehmigen |
94
- | **G2 Product** | Was gebaut wird und wie es sich in der Nutzung anfühlt | `/wdi-product`<br>`/wdi-ux` (optional) | `.what-rendered/_prd/<slug>/prd.md` | Die funktionalen Versprechen (FR) genehmigen |
95
- | **G3 Blueprint** | Das Gesamtbild des Produkts, einmal pro Produkt | `/wdi-blueprint` | `.how-rendered/blueprint.md` | Das Architektur-Rückgrat genehmigen |
96
- | **G4 Component** | Wie eine Komponente gebaut wird (übersprungen bei `mode: catalog`) | `/wdi-component` | `.how-rendered/<pc>/SDD-<pc>.md` | Das Softwaredesign genehmigen |
97
- | **G5 Release** | Ob es fertig und nachgewiesen ist | `/wdi-build` | Die RTM-Zeilen der Spezifikation in `.control/generated/` und der Testnachweis jedes Tickets | Die Spezifikation als fertig abnehmen oder zurückgeben |
98
-
99
- **Verfeinern, nicht weitergehen.** Ein einziges "Nein" auf eine mit Stern (★) markierte Frage der Checkliste hält das Gate an. Verfeinern Sie das Dokument und führen Sie das Gate erneut aus; genehmigen Sie es nicht mit dem Plan, es später zu korrigieren.
100
-
101
- #### Zwei Felder, die nie verschmelzen
102
- - **`mode`** legt fest, wie tief die Dokumente jeder Komponente gehen. `catalog` (Standard): nichts über das Blueprint hinaus, und G4 wird übersprungen. `outline`: vollständige Abläufe für bis zu 3 Use Cases, lokale Geschäftsregeln, eine Entscheidungszusammenfassung. `guarded`: fügt einen Abschnitt `Failure Behaviour` für jede Grenze sowie Dokumente zu Drittanbieter-Integrationen hinzu. `deep`: fügt Robustheitsanalyse, einen Vertrag pro Endpoint, ein Datenwörterbuch, Ablaufdiagramme und Zustandsautomaten hinzu.
103
- - **`risk_accepted`** legt fest, wie streng die Überprüfung ist. `high` (Sie akzeptieren viel Risiko): die grundlegenden Linsen für Struktur und Text. `medium`: fügt die Edge-Case-Linse hinzu. `low`: fügt die Edge-Case-Linse hinzu, und der Code braucht zwei Reviewer, die nicht der Builder sind.
104
-
105
- Würde ein Feld beides festlegen, wäre der einzige Weg zu einem schlanken Dokument, mehr Risiko in das Risikoprotokoll zu schreiben, als Sie tatsächlich akzeptieren.
106
-
107
- ---
108
-
109
- ### Option B: Autonome Tagesabläufe (Daily Tier)
110
- Sobald die Architektur steht, läuft die tägliche Arbeit als Tagesrhythmus über vier Skills, die Sie in Ihrem Agenten eintippen:
111
-
112
- 1. **`/wdi-daily-what-to-build [reviewer] <notes>`**
113
- Wandelt Notizen aus manuellen Tests, QA-Beobachtungen oder Fehlerberichte in eine geprüfte Spezifikation oder ein geprüftes Ticket auf dem Entwicklungsbranch um, für einen späteren Autopilot-Lauf. Dort hört es auf: Es macht nie einen Commit oder Push und startet nie den Autopilot.
114
- 2. **`/wdi-daily-autopilot [self-review] [peer] [interval] [--skip-peer-review]`**
115
- Prüft, ob ein akzeptiertes Mandat vorliegt, und führt den Preflight aus, wenn keines vorliegt, ermittelt die Reviewer aus der lokalen Konfiguration und startet die Schleife (Standard `/loop 10m /wdi-autopilot`). Die Schleife arbeitet auf dem Branch `autopilot/<mandate-id>`, schreibt den Code test-first, hält jede Entscheidung in ihrem Ledger fest und endet mit einem PR, der zur Überprüfung bereit ist. Der Owner merged.
116
- 3. **`/wdi-daily-what-to-test [web <target> | mobile <target> | desktop]`**
117
- Nach einem Merge: synchronisiert den Entwicklungsbranch, räumt gemergte Branches und Worktrees ab, bereitet die App für manuelle Tests vor und erstellt eine Checkliste aus den seit der letzten Synchronisation geschlossenen Tickets (`before_sync..HEAD`). Ohne Argument synchronisiert es nur, räumt ab und erstellt die Checkliste.
118
- 4. **`/wdi-prune-or-archive [--spec <id> | --all-closed] [--archive | --prune] [--dry-run]`**
119
- Verschiebt geschlossene Spezifikationen aus `.scratch/` nach `.archive/specs/` oder entfernt sie mit `git rm`, über `lifecycle.py`, das zuerst prüft und bei einem Fehler zurückrollt. Die Zeile der Spezifikation bleibt in `specs.yaml`. Ohne Argument fragt es nach.
120
-
121
- ---
122
-
123
- ### Option C: Schneller Pfad (`/implement` direkt)
124
- Eine Korrektur darf jedes Gate überspringen, wenn sie kein FR, keinen UC, kein AD-N und nicht das Domänenmodell ändert, höchstens ein Ticket umfasst und weder Geld noch personenbezogene Daten noch eine Drittanbieter-Integration berührt. Sie führen `/implement` direkt aus, ohne Wrapper-Skill. Stellt sich heraus, dass die Korrektur ein FR berührt, stoppt die Arbeit und wird zu einer Spezifikation der Größe S (höchstens 3 Tickets), die über `wdi-build` läuft.
125
-
126
- ---
127
-
128
- ## Praxisregeln
129
-
130
- Betriebsregeln aus dem Betrieb autonomer Coding-Schleifen in echten Produkt-Repositories:
131
-
132
- ### 1. Builder fest beim Koordinator (`builder: coordinator`)
133
- In `wdi-daily-autopilot` ist `roles.builder` in `.control/custom-dispatch.yaml` fest auf `coordinator` gesetzt. Das Delegieren von Code an Subagenten führte zu falschen Abschlussmeldungen (ein Subagent behauptete, die Tests seien bestanden, ohne eine Datei bearbeitet zu haben). Die koordinierende Sitzung schreibt den Code selbst, test-first.
134
-
135
- ### 2. Reviewer nur mit Lesezugriff
136
- Peer-Reviewer laufen nur mit Lesezugriff. Sie hinterfragen Edge Cases und lesen Diffs, ändern aber nie Code und führen nie Builds aus; nur die koordinierende Sitzung schreibt. Bei `risk_accepted: low` wird das Umgehen des Peer-Reviews abgelehnt, weil der Code dort zwei Reviewer braucht, die nicht der Builder sind.
137
-
138
- ### 3. Dateisperren unter Windows (Desktop Process Gate)
139
- Unter Windows hält ein laufendes App-Binary oder ein Build-Daemon im Hintergrund Datei-Handles offen, und ein Rebuild oder das Löschen eines Worktrees schlägt dann mit `Access is denied` fehl. Mit dem Ziel `desktop` prüft `wdi-daily-what-to-test` vor dem Rebuild, ob das App-Binary noch läuft. Es schließt die App nur, wenn sein eigener vorheriger Smoke-Lauf sie gestartet hat; andernfalls meldet es die PID und hält an, damit Sie sie selbst schließen können. Es beendet nie einen Prozess gewaltsam.
140
-
141
- ### 4. Die Schleife läuft auf ihrem eigenen Branch
142
- Das Verfassen von Spezifikationen und Tickets geschieht auf dem Entwicklungsbranch. Die Schleife läuft auf ihrem eigenen Branch, `autopilot/<mandate-id>`, in einem isolierten Worktree oder in einem sauberen Checkout, den nur dieser Lauf nutzt. Sie läuft nie auf einem geteilten oder unsauberen Checkout.
143
-
144
- ### 5. Ein Cloud-CI-Lauf pro Autopilot-Lauf
145
- Die Schleife macht pro Ticket einen Commit, und die lokale Testsuite ist während des Laufs der Nachweis. Cloud CI läuft einmal pro Autopilot-Lauf, am Ende: wenn der eine PR als bereit zur Überprüfung markiert wird oder wenn der Workflow einmal ausgelöst wird. Pushes während des Laufs starten keinen Cloud-Lauf.
146
-
147
- ### 6. Maschinenlokale Smoke-Dateien
148
- Smoke-Cursor (`.work/smoke/last-sync`) und Runtime-Manifeste gehören zu einer Maschine. Der Installer fügt `.work/smoke/` zu `.gitignore` hinzu, sodass maschinenlokale Smoke-Dateien den Arbeitsbaum nie unsauber hinterlassen.
149
-
150
- ---
151
-
152
- ## Konfiguration (`custom-dispatch.yaml`)
153
-
154
- Maschinenspezifische Runner-Befehle und Modell-Flags liegen in `.control/custom-dispatch.yaml`. Der Installer erstellt die Datei aus `.control/custom-dispatch.yaml.example`, wenn sie fehlt, und fügt sie zu `.gitignore` hinzu; nur das Beispiel wird committet.
155
-
156
- Ein als Reviewer benannter Runner MUSS nur Lesezugriff haben. Das Flag für Lesezugriff je CLI: `claude --permission-mode plan`, `kiro-cli --trust-tools=fs_read`, `cursor-agent --mode plan`. Die Beispiel-Runner in der Vorlage verwenden es alle.
157
-
158
- ---
159
-
160
- ## Skill-Verzeichnis (22)
161
-
162
- WDI Method installiert 22 Skills: 7 Gate-Skills, 5 für das Daily Tier (einschließlich `wdi-autopilot`) und 10, die Sie jederzeit ausführen.
163
-
164
- Wie ein Skill startet:
165
- - **Sie tippen ihn ein**: die vier Daily-Tier-Skills, `wdi-build` und `wdi-explain-to-me` (sie tragen `disable-model-invocation: true`).
166
- - **Sie tippen ihn ein, oder der Agent nennt ihn und wartet auf Ihre Freigabe**: die übrigen Skills.
167
- - **Der Agent darf ihn selbstständig ausführen (nur Lesezugriff)**: `wdi-help`.
168
- - **Ausgelöst durch `/loop` unter einem akzeptierten Mandat**: `wdi-autopilot`. Unter einem Mandat führt `wdi-autopilot` auch die übrigen Skills aus.
169
-
170
- | Skill | Was er tut | Wie er startet |
171
- |---|---|---|
172
- | **Gate-Skills** | | |
173
- | `/wdi-init` | Vor G1 und am Ende von G2: richtet Registries, Komponenten, `mode` und `risk_accepted`, die zwei Strukturkarten, die Engine-Prüfung und Inventar-Leser ein. | Sie tippen ihn ein, oder der Agent nennt ihn |
174
- | `/wdi-problem` | G1. Führt den Product-Brief-Skill von BMad aus und prüft den Brief anschließend anhand des Leitfadens der Methode. Schreibt den Brief nie selbst. | Sie tippen ihn ein, oder der Agent nennt ihn |
175
- | `/wdi-product` | G2. Führt den PRD-Skill von BMad für ein neues PRD oder ein geändertes Versprechen aus und prüft es anschließend anhand des PRD-Leitfadens. Schreibt das PRD nie selbst. | Sie tippen ihn ein, oder der Agent nennt ihn |
176
- | `/wdi-ux` | Optional, zusammen mit G2. Führt den UX-Skill von BMad aus und legt die Designergebnisse dort ab, wo sie hingehören. Schreibt nie selbst UX-Inhalte. | Sie tippen ihn ein, oder der Agent nennt ihn |
177
- | `/wdi-blueprint` | G3, einmal pro Produkt. Das Gesamtbild des Produkts: Use Cases, Akteure, Domänenmodell, Geschäftsregeln, Glossar, das Architektur-Rückgrat, C4 sowie die API-, Tabellen- und Bildschirminventare. | Sie tippen ihn ein, oder der Agent nennt ihn |
178
- | `/wdi-component` | G4. Die Tiefe einer Komponente, so tief wie ihr `mode` und nicht tiefer. Übersprungen bei `mode: catalog`. | Sie tippen ihn ein, oder der Agent nennt ihn |
179
- | `/wdi-build` | G5. Eine Spezifikation von offen bis geschlossen: Sie führen `to-spec` und `to-tickets` aus, jedes Ticket geht bis zu einem grünen PR, dann wird die Spezifikation geschlossen. Es merged nie. | Sie tippen ihn ein |
180
- | **Daily Tier** | | |
181
- | `/wdi-daily-what-to-build` | Wandelt Notizen aus manuellen Tests in eine geprüfte Spezifikation oder ein geprüftes Ticket für einen späteren Autopilot-Lauf um. Hält vor Code, Commit oder Push an. | Sie tippen ihn ein |
182
- | `/wdi-daily-autopilot` | Prüft, ob ein akzeptiertes Mandat vorliegt (führt den Preflight aus, wenn keines vorliegt), ermittelt die Reviewer aus der lokalen Konfiguration und startet die Schleife, standardmäßig alle 10 Minuten. | Sie tippen ihn ein |
183
- | `/wdi-autopilot` | Die Schleife selbst: arbeitet jedes FR unter einem akzeptierten Mandat ab, auf einem Branch mit einem PR, und schreibt jede Entscheidung in ein Ledger. | Ausgelöst durch `/loop` unter einem akzeptierten Mandat |
184
- | `/wdi-daily-what-to-test` | Nach einem Merge: synchronisiert den Entwicklungsbranch, räumt gemergte Branches und Worktrees ab, bereitet die App für manuelle Tests vor und erstellt eine Checkliste aus den geschlossenen Tickets. | Sie tippen ihn ein |
185
- | `/wdi-prune-or-archive` | Verschiebt geschlossene Spezifikationen nach `.archive/specs/` oder entfernt sie mit `git rm`, über `lifecycle.py`, das zuerst prüft und bei einem Fehler zurückrollt. Die Zeile der Spezifikation bleibt in `specs.yaml`. | Sie tippen ihn ein |
186
- | **Jederzeit** | | |
187
- | `/wdi-help` | Liest die Status-Registry und nennt Ihnen das aktuelle Gate, die offenen Spezifikationen und den nächsten Skill. | Der Agent darf ihn selbstständig ausführen (nur Lesezugriff) |
188
- | `/wdi-explain-to-me` | Übernimmt das Lesen, bevor Sie entscheiden: recherchiert und informiert Sie dann in sechs festen Abschnitten. Schreibt keine Datei. | Sie tippen ihn ein |
189
- | `/wdi-decision` | Eröffnet, akzeptiert und wendet eine nummerierte Entscheidung (`DEC-`) an und überträgt sie in die Dokumente, die sie regelt. | Sie tippen ihn ein, oder der Agent nennt ihn |
190
- | `/wdi-question` | Legt etwas, das sich jetzt nicht entscheiden lässt, in einer von vier Listen in `.control/questions/` ab und schließt es, wenn die Antwort eintrifft. | Sie tippen ihn ein, oder der Agent nennt ihn |
191
- | `/wdi-log` | Hält ein beendetes Meeting oder eine nicht technische Tatsache fest, die einschränkt, was gebaut werden darf. | Sie tippen ihn ein, oder der Agent nennt ihn |
192
- | `/wdi-report` | Zahlen zum Projekt: Fortschritt, Schätzungen, Aufgabenzeilen für einen Tracker oder ein eigenständiger Brief oder ein eigenständiges PRD. Erfindet nie eine Zahl. | Sie tippen ihn ein, oder der Agent nennt ihn |
193
- | `/wdi-reconcile` | Vor einem Gate oder nach einer Reihe von Änderungen: meldet Drift zwischen `.what`, `.how`, `.control` und den Regeln der Methode. Nur Lesezugriff. | Sie tippen ihn ein, oder der Agent nennt ihn |
194
- | `/wdi-review` | Prüft jedes Korpusdokument und muss vor einem Gate für das Rückgrat, SRS, SDD und SPEC laufen. Seine Linsen folgen `risk_accepted`. Nicht für Code-Reviews. | Sie tippen ihn ein, oder der Agent nennt ihn |
195
- | `/wdi-systematic-debugging` | Für jeden Fehler, fehlschlagenden Test oder fehlgeschlagenen Build, bevor eine Korrektur vorgeschlagen wird: die Grundursache finden und jeweils eine Hypothese testen. | Sie tippen ihn ein, oder der Agent nennt ihn |
196
- | `/wdi-upgrade` | Direkt nach `wdi-method update`: überführt Dokumente und Registry-Dateien, die noch in der alten Form vorliegen, in die neue und prüft anschließend, ob die Validierung grün ist. | Sie tippen ihn ein, oder der Agent nennt ihn |
197
-
198
- ---
199
-
200
- ## Repository-Struktur
201
-
202
- ```text
203
- .constitution/
204
- method/ The method itself: overwritten by every update; never edit here
205
- project/ Product-owned rules and inventory readers: kept across updates
206
- .control/
207
- registry/ The registries: index.yaml · goals.yaml · specs.yaml · components.yaml
208
- generated/ Status and RTM projections written by validate.py (never by hand)
209
- decisions/ Decisions and owner mandates (DEC-*.md)
210
- memlog/ Ledgers recording autonomous loop decisions
211
- test-targets/ Hand-testing templates (desktop.md, web.md, mobile.md)
212
- .scratch/<spec-id>-<slug>/ Active spec workspaces (SPEC.md and tickets)
213
- .archive/ Archived closed specs
214
- .what/ & .how/ Working corpus documents (brief, PRD, SRS, blueprint, SDD)
215
- .what-rendered/ Rendered pages for G1 and G2 (generated)
216
- .how-rendered/ Rendered pages for G3 and G4 (generated)
217
- .work/ Scratch that empties when a task closes
218
- ```
219
-
220
- ---
221
-
222
- ## Mitwirkung
223
-
224
- Jeder Beitrag zu WDI Method beantwortet eine Frage: **Macht dies die Überprüfungsschicht vertrauenswürdiger, oder macht es sie nur dicker?** Siehe [CONTRIBUTING.md](CONTRIBUTING.md).
225
-
226
- ### Fixture Corpus und lokale Verifikation
227
- Änderungen an Validatoren und an der Methode werden gegen das Fixture Corpus (`tests/fixture/`) nachgewiesen. Führen Sie die Suite aus, bevor Sie einen Pull Request öffnen:
228
- ```bash
229
- npm test
230
- ```
231
- Die Suite führt die vier Python-PEP-723-Skripte (`validate.py`, `timeline.py`, `inventory.py`, `lifecycle.py`) gegen das Fixture aus und prüft die Plattform-Registry, die Dateien, die jede Plattform erhält, sowie die Integrität des Kits.
232
-
233
- ### Richtlinie für öffentliche generische Pakete
234
- WDI Method wird in der öffentlichen npm-Registry veröffentlicht. Es darf nie private Kundennamen, kommerzielle Produktidentitäten, Zugangsdaten oder absolute Dateisystempfade enthalten.
235
-
236
- ---
237
-
238
- ## Lizenz und Datenschutz
239
-
240
- - **Code-Lizenz:** [MIT-Lizenz](LICENSE).
241
- - **Datenschutz:** WDI Method selbst macht keine Netzwerkaufrufe; Ihr Coding-Agent kommuniziert weiterhin mit seinem Modellanbieter. Siehe [PRIVACY.md](PRIVACY.md) und [SECURITY.md](SECURITY.md).
242
-
243
- ## The name and the icon
244
-
245
- Maßgeblich ist der folgende englische Text.
246
-
247
- The MIT License grants broad rights over the code. It says nothing about names or logos,
248
- and it does not oblige the studio to hand over either — so the licence above covers this
249
- repository's code, not the name **WDI Method**, not **Wira Delta Indonesia**, and not any
250
- associated visual marks or logos.
251
-
252
- You may use those names to refer to this project: "based on WDI Method", "a fork of WDI Method",
253
- or "compatible with WDI Method". You may not use them as the name of your own product or
254
- methodology, or in a way that suggests you are this project or endorsed by it.
255
-
256
- If you publish a modified distribution or fork, please give it your own name, so the
257
- engineers using it know whom to ask when something behaves unexpectedly. The code is yours
258
- to take; the name is not.
259
-
260
- ---
261
-
262
- Wir verwenden dieselbe Methode in Kundenprojekten. [Wira Delta Indonesia kontaktieren](https://wiradelta.id/#contact).