bmad-plus 0.17.1 → 0.19.0

package/CHANGELOG.md

@@ -5,7 +5,36 @@ All notable changes to BMAD+ will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.19.0] - 2026-09-27
+
+### Added
+
+- **`bmad-plus review` — evidence for code review.** `review scope <id>` seals what a review must cover: files changed since the merge base (or the working tree), each excluded file with its reason (secrets first and never re-included, binaries, deletions, generated or vendored files), ordered review units and a scope hash. `review anchor <id>` locates every finding by the code it quotes, never by a line number, and reports ambiguous or unlocated quotes. `review gate <id>` derives the verdict from coverage — incomplete, findings or clean — never from the number of findings. Findings use closed enums that are refused, not coerced, when unknown. The Dev Studio code-review workflow and Sentinel use it when the CLI is available. See `docs/specs/code-review-evidence.md`.
+- Review triage keeps a finding by default and refutes it only on a quoted ground; security, data-loss and money findings without one stay unresolved. `tools/build/verify-action-pins.js` makes CI refuse a third-party action not pinned to a full commit.
+
+### Fixed
+
+- `review` and `uat` read JSON written by Windows PowerShell 5.1, whose `Set-Content -Encoding utf8` adds a byte-order mark that JSON parsing refused.
+- The release workflow accepts the one-element array current npm returns for `npm view … --json`; 0.18.0 was published intact and then wrongly reported as mismatched.
+
+## [0.18.0] - 2026-09-25
+
+### Added
+
+- **The acceptance page names what it guarantees, and the build refuses a template that lost one.** `uat build --json` lists sixteen page guarantees (`hidden-before-start`, `verified-local-write`, `honest-save-status`, `save-on-every-change`, `restore-before-capabilities`, `revision-guard`, `other-tab-notice`, `unreadable-draft-kept`, `progress-accessible`, `storage-explained`, `finished-is-not-accepted`, …); a template missing one is not built. A jsdom suite replays every scenario of the FormaPro incident of 2026-09-25 — start, tick, note without blur, immediate reload, storage refused, unreadable draft, amended recipe, two tabs, artifact database precedence, local server — and `tools/qa/uat-page-browser-check.js` walks the essential pass in Chromium, because the original defect lived in the stylesheet.
+- The page offers a run that answered another revision of the recipe instead of pouring it in: identical lines keep their answers, changed lines are asked again, the earlier run stays untouched and exportable, and the new run records `carriedFrom`. Another run can be started while the previous one stays saved; the resume list shows the newest copy of each run first, with its progress.
+- Finishing with unanswered lines is questioned on the page itself and confirmed by a second click, never through a dialog a host may swallow. A change after finishing is kept, dated, and said on screen. A blocked line asks "What stopped you?"; a note already written stays in view whatever the answer became.
+- `uat serve` refuses an older copy of a run (409), any host name but its own (403), and prints the port it actually bound. A tester whose name has no Latin letter signs the run with a stable hash instead of "anonymous".
+- The skill carries the contract: an agent builds the page with the command, never writes it by hand, plays the essential pass in a real browser before handing the page over, tells the tester where the answers live, and says in the delivery which checks ran.
+
+### Fixed
+
+- **The acceptance page could say "saved" without a verified write.** A refused write to the browser (quota, private window, blocked storage) was swallowed and the status still read saved. A write now counts only once it reads back — the run and the pointer that finds it — and a failed save shows a persistent warning, questions leaving the page, and keeps the export available. A failed remote copy is reported as such, with the local copy kept.
+- The browser's copy of a run is restored synchronously on reload, before the local-server probe and the artifact database answer or hang; an older remote copy no longer overwrites a newer local one, and a newer remote one is adopted and written back to the browser.
+- A stored run that cannot be read is reported and exportable, never deleted in silence. Two tabs on the same run converge on the latest change, and the page says so.
+- The progress bar exposes the share of lines answered as an accessible `progressbar` — answered, not passed — next to the seen / not seen / blocked counts, and the page explains where answers live and what can make them disappear. Finishing says it is not an acceptance. The diacritics range in run ids is written as escapes so a charset hop cannot corrupt it.
+- `update`, `update --latest` and `update-check` run outside an installed project now say which folder they looked in and how to run them from the project folder (or with `--directory`), instead of a raw `ENOENT` error or an unexplained `invalid-installation` status. `update-check --json` keeps its JSON on stdout and writes the guidance to stderr.
+- The release workflow's npm verification now reports the integrity npm actually served, so a registry availability delay can no longer read as a different archive.
 
 ## [0.17.1] - 2026-09-24
 

package/README.md

@@ -1,8 +1,8 @@
 # BMAD+
 
-[![Version](https://img.shields.io/badge/version-0.17.1-blue)](https://www.npmjs.com/package/bmad-plus)
+[![Version](https://img.shields.io/badge/version-0.19.0-blue)](https://www.npmjs.com/package/bmad-plus)
 
-**Version 0.17.1** · Node.js `>=20.0.0` · MIT
+**Version 0.19.0** · Node.js `>=20.0.0` · MIT
 
 Project-local AI development workflows with clear roles, shared context, safe updates and coding-tool adapters
 
@@ -35,7 +35,7 @@ Run the installer. Select the adapters for the AI tools you use and the packs yo
 **In your project terminal:**
 
 ```sh
-npx bmad-plus@0.17.1 install
+npx bmad-plus@0.19.0 install
 ```
 
 The installer creates the agent instructions, shared project spine and selected tool adapters. Optional packs may need additional runtimes or API access.
@@ -71,7 +71,7 @@ Ask Sentinel to check the change against its acceptance criteria. Ask for test e
 **In your AI assistant:**
 
 ```text
-Sentinel, review this change against the acceptance criteria. Check the main success and failure paths, report remaining issues and summarize what the next session needs to know.
+Sentinel, review this change against the acceptance criteria. Check the main success and failure paths, report remaining issues and summarize what the next session needs to know. If the BMAD+ CLI is available, seal the scope with bmad-plus review scope, quote the code of every finding, account for every selected file, then report what bmad-plus review gate answers.
 ```
 
 Read the changes and test results. The assistant follows the permissions and capabilities of its host tool.
@@ -136,7 +136,7 @@ Expected result: bounded assignments, explicit dependencies and one integrated r
 Use when a version reaches your test environment and someone must check it on screen.
 
 ```text
-Sentinel, write the acceptance recipe for this delivery on our test environment. One step per gesture, one verifiable fact per line, on-screen labels quoted from the code, and mark the steps that write for real. Build the page, then tell me the link, how long it takes and what I must not skip. Use disposable test data when possible, name the exact folder and files each command changes, and keep automated evidence separate from the person’s answers.
+Sentinel, write the acceptance recipe for this delivery on our test environment. One step per gesture, one verifiable fact per line, on-screen labels quoted from the code, and mark the steps that write for real. Build the page, then tell me the link, how long it takes and what I must not skip. Use disposable test data when possible, name the exact folder and files each command changes, and keep automated evidence separate from the person’s answers. Before handing the page over, build it with uat build, check the guarantees it lists, play the essential pass yourself in a real browser — start, tick, type a remark, reload, everything back — and tell me which checks ran.
 ```
 
 Expected result: a page a non-technical person can play, and a run the agent reads back to classify every failure before anything is fixed.
@@ -171,20 +171,18 @@ Read AGENTS.md and the available project memory. Summarize the last verified sta
 
 Expected result: a short, evidence-based restart. Project notes are useful context and still need to be checked against the current work.
 
-## What’s new in 0.17.1
+## What’s new in 0.19.0
 
-Safer installs and cleaner updates
+Code reviews you can check
 
-Installing over a different version now stops and points to update, re-installs keep your settings, and updates remove files a version no longer ships while keeping a restorable backup. Some install behaviors changed; review your scripts before rerunning them.
+bmad-plus review seals what a review must cover, locates every finding by the code it quotes, and derives the verdict from coverage instead of the number of findings. Review triage now keeps a finding unless a quoted ground refutes it. Nothing changes in how you install or update.
 
-- install refuses to overwrite a different installed version. A downgrade is refused; for an upgrade, run bmad-plus update, which keeps backups and restorable receipts. Re-installing the same version only adds missing files.
-- Re-installing keeps your _bmad/config.yaml settings and adds only missing defaults. The manifest and configuration are written atomically.
-- --packs and --tools add to the previous installation instead of replacing it. An unknown pack or tool ID fails before any write and lists the valid IDs.
-- update deletes unchanged files that the new version no longer ships, backs them up in the update receipt and restores them with --restore. Files you edited are kept and reported.
-- A project lock left by a crashed process is taken over automatically when its owner is provably no longer running on this machine; doctor reports other stale locks with the manual remedy.
-- Without a terminal, installs use --lang, then the system locale, then English. --yes with no detected AI tool writes no adapter files. uninstall accepts -d/--directory.
-- The npm package no longer includes maintainer release scripts. OSINT and Shield carry legal and AI-generated-output notices; Shadow is described as governed public-source research.
-- Translated READMEs mirror the public README, which adds a non-affiliation notice and a factual comparison. The website shows the install command up front and supports a dark color scheme.
+- bmad-plus review scope lists the files changed since the base branch or in your working tree, names why every other changed file is left out (secret, binary, deleted, generated), splits the work into ordered units and seals it with a hash. Secret files are excluded before any include pattern and never come back.
+- Findings go in findings.json and quote the code they are about, word for word. bmad-plus review anchor finds that code in the file and reports a quote it cannot find, or finds twice, instead of trusting a line number. Unknown categories or severities are refused, not guessed.
+- bmad-plus review gate answers incomplete, findings or clean. A review is incomplete while any selected file is missing from coverage.json or an open finding is not anchored; clean covers the reviewed scope only.
+- Sentinel and the Dev Studio code-review workflow keep a finding by default and refute it only on a quoted ground: the code is absent, the code contradicts it, or it duplicates another finding. Security, data-loss and money findings without such a quote stay unresolved.
+- The maintainer README now states what BMAD+ deliberately does not do: no model runtime, no background process, no review engine that repositions findings, no automatic fixes from a review.
+- Release tooling accepts the one-element array npm now returns for integrity checks. Continuous integration checks that every third-party GitHub Action is pinned to a full commit.
 
 ## Version History
 
@@ -192,9 +190,9 @@ These dates identify reviewed CHANGELOG notes, not npm publication dates. The we
 
 | Version | Release-notes date | Reviewed summary |
 | --- | --- | --- |
+| 0.19.0 | 2026-09-27 | bmad-plus review seals what a review must cover, locates every finding by the code it quotes, and derives the verdict from coverage instead of the number of findings. Review triage now keeps a finding unless a quoted ground refutes it. Nothing changes in how you install or update. |
+| 0.18.0 | 2026-09-25 | The acceptance page now verifies every save, restores your answers on reload before anything else, keeps runs from other revisions and other tabs apart, and names sixteen guarantees the build refuses to lose. Nothing changes in how you install or update; rebuild your recipe pages to get the new page. |
 | 0.17.1 | 2026-09-24 | Installing over a different version now stops and points to update, re-installs keep your settings, and updates remove files a version no longer ships while keeping a restorable backup. Some install behaviors changed; review your scripts before rerunning them. |
-| 0.17.0 | 2026-09-22 | Acceptance pages now prevent silent answer loss and empty exports, recipes build by their own identifier, and project release checks work directly with Node on Windows. Guides add practical prompts for reading results and preserving project context. |
-| 0.16.0 | 2026-09-16 | A delivery now produces a step-by-step page a person plays, and their run comes back as evidence the agents read, classify and gate on. This release also carries what 0.15.0 had prepared and never shipped: durable Nexus execution, evidence-ranked memory and scored checks for every pack. |
 
 [Release history and update guide](https://bmad-plus.rochetta.fr/docs/#changelog) · [All published npm versions](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-plus",
-  "version": "0.17.1",
+  "version": "0.19.0",
   "description": "Project-local AI development workflows with clear roles, shared context, safe updates and coding-tool adapters",
   "homepage": "https://bmad-plus.rochetta.fr",
   "keywords": [
@@ -52,6 +52,7 @@
     "check:counts:full": "jest --coverage=false --silent --json --outputFile=coverage/jest-report.json && node tools/build/check-counts.js --jest-report coverage/jest-report.json",
     "uat:spec": "node src/bmad-plus/skills/bmad-plus-uat/templates/uat-spec-present.mjs --dir recettes",
     "uat:gate": "node src/bmad-plus/skills/bmad-plus-uat/templates/uat-release-gate.mjs --dir recettes --cli tools/cli/bmad-plus-cli.js",
+    "qa:uat-browser": "node tools/qa/uat-page-browser-check.js",
     "lint": "eslint tools/ tests/",
     "format": "prettier --write \"tools/**/*.js\" \"tests/**/*.js\"",
     "format:check": "prettier --check \"tools/**/*.js\" \"tests/**/*.js\"",
@@ -136,6 +137,7 @@
     "eslint": "^10.6.0",
     "husky": "^9.0.0",
     "jest": "^30.4.2",
+    "jsdom": "^26.1.0",
     "prettier": "^3.4.0"
   }
 }

package/readme-international/README.de.md

@@ -4,9 +4,9 @@
   <a href="../README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | 🌐 <b>Deutsch</b>
 </div>
 
-[![Version](https://img.shields.io/badge/version-0.17.1-blue)](https://www.npmjs.com/package/bmad-plus)
+[![Version](https://img.shields.io/badge/version-0.19.0-blue)](https://www.npmjs.com/package/bmad-plus)
 
-**Version 0.17.1** · Node.js `>=20.0.0` · MIT
+**Version 0.19.0** · Node.js `>=20.0.0` · MIT
 
 Projektlokale KI-Entwicklungsworkflows mit klaren Rollen, gemeinsamem Kontext, sicheren Updates und Adaptern für Coding-Tools.
 
@@ -39,7 +39,7 @@ Starte das Installationsprogramm. Wähle die Adapter deiner KI-Werkzeuge und die
 **Im Terminal deines Projekts:**
 
 ```sh
-npx bmad-plus@0.17.1 install
+npx bmad-plus@0.19.0 install
 ```
 
 Die Installation erstellt Agentenanweisungen, die gemeinsame Projektbasis und die gewählten Adapter. Optionale Packs können weitere Laufzeitumgebungen oder API-Zugänge benötigen.
@@ -75,7 +75,7 @@ Bitte Sentinel, die Änderung anhand der Akzeptanzkriterien zu prüfen. Fordere
 **In deinem KI-Assistenten:**
 
 ```text
-Sentinel, prüfe diese Änderung anhand der Akzeptanzkriterien. Überprüfe die wichtigsten Erfolgs- und Fehlerfälle, nenne offene Probleme und fasse zusammen, was die nächste Sitzung wissen muss.
+Sentinel, prüfe diese Änderung anhand der Akzeptanzkriterien. Überprüfe die wichtigsten Erfolgs- und Fehlerfälle, nenne offene Probleme und fasse zusammen, was die nächste Sitzung wissen muss. Wenn das BMAD+ CLI verfügbar ist, versiegle den Umfang mit bmad-plus review scope, zitiere den Code jedes Befunds, belege jede ausgewählte Datei und berichte, was bmad-plus review gate antwortet.
 ```
 
 Lies die Änderungen und Testergebnisse. Der Assistent arbeitet innerhalb der Rechte und Fähigkeiten seines Host-Werkzeugs.
@@ -140,7 +140,7 @@ Erwartetes Ergebnis: begrenzte Aufträge, klare Abhängigkeiten und eine gemeins
 Verwenden Sie dies, wenn eine Version auf Ihrer Testumgebung ankommt und jemand sie am Bildschirm prüfen muss.
 
 ```text
-Sentinel, schreibe das Abnahmerezept für diese Lieferung auf unserer Testumgebung. Ein Schritt je Handgriff, eine überprüfbare Tatsache je Zeile, Bildschirmtexte aus dem Code zitiert, und markiere die wirklich schreibenden Schritte. Baue die Seite und nenne mir Link, Dauer und was ich nicht überspringen darf. Verwende möglichst wegwerfbare Testdaten, benenne den Ordner und die Dateien, die jeder Befehl ändert, und halte automatisierte Nachweise von den Antworten der Person getrennt.
+Sentinel, schreibe das Abnahmerezept für diese Lieferung auf unserer Testumgebung. Ein Schritt je Handgriff, eine überprüfbare Tatsache je Zeile, Bildschirmtexte aus dem Code zitiert, und markiere die wirklich schreibenden Schritte. Baue die Seite und nenne mir Link, Dauer und was ich nicht überspringen darf. Verwende möglichst wegwerfbare Testdaten, benenne den Ordner und die Dateien, die jeder Befehl ändert, und halte automatisierte Nachweise von den Antworten der Person getrennt. Bevor du mir die Seite übergibst, baue sie mit uat build, prüfe die aufgelisteten Garantien, spiele den wesentlichen Durchgang selbst in einem echten Browser — starten, ankreuzen, eine Bemerkung tippen, neu laden, alles ist wieder da — und sage mir, welche Prüfungen liefen.
 ```
 
 Erwartetes Ergebnis: eine Seite, die auch eine nicht technische Person durchgehen kann, und ein Durchlauf, den der Agent zurückliest, um jeden Fehlschlag einzuordnen, bevor etwas korrigiert wird.
@@ -175,20 +175,18 @@ Lies AGENTS.md und die verfügbare Projekterinnerung. Fasse den letzten geprüft
 
 Erwartetes Ergebnis: ein kurzer, belegter Wiedereinstieg. Projektnotizen liefern Kontext und müssen mit dem aktuellen Stand abgeglichen werden.
 
-## Neu in 0.17.1
+## Neu in 0.19.0
 
-Sicherere Installationen und sauberere Updates
+Code-Reviews, die sich prüfen lassen
 
-Eine Installation über eine andere Version bricht jetzt ab und verweist auf update, eine erneute Installation behält deine Einstellungen, und Updates entfernen Dateien, die eine Version nicht mehr mitliefert, mit wiederherstellbarer Sicherung. Einige Installationsabläufe ändern sich: Prüfe deine Skripte, bevor du sie erneut ausführst.
+bmad-plus review versiegelt, was ein Review abdecken muss, findet jeden Befund über den Code, den er zitiert, und leitet das Urteil aus der Abdeckung ab statt aus der Zahl der Befunde. Die Review-Sichtung behält einen Befund jetzt, solange kein zitierter Grund ihn widerlegt. An Installation und Update ändert sich nichts.
 
-- install überschreibt keine andere installierte Version mehr. Ein Downgrade wird abgelehnt; für ein Upgrade führe bmad-plus update aus, das Sicherungen und wiederherstellbare Belege anlegt. Eine erneute Installation derselben Version ergänzt nur fehlende Dateien.
-- Eine erneute Installation behält die Einstellungen in _bmad/config.yaml und ergänzt nur fehlende Standardwerte. Manifest und Konfiguration werden atomar geschrieben.
-- --packs und --tools ergänzen die vorherige Installation, statt sie zu ersetzen. Eine unbekannte Pack- oder Tool-Kennung schlägt vor jedem Schreibvorgang fehl und nennt die gültigen Kennungen.
-- update löscht unveränderte Dateien, die die neue Version nicht mehr mitliefert, sichert sie im Update-Beleg und stellt sie mit --restore wieder her. Von dir bearbeitete Dateien bleiben erhalten und werden gemeldet.
-- Eine Projektsperre, die ein abgestürzter Prozess hinterlassen hat, wird automatisch übernommen, wenn ihr Besitzerprozess auf diesem Rechner nachweislich nicht mehr läuft; doctor meldet andere veraltete Sperren mit der manuellen Abhilfe.
-- Ohne Terminal verwendet die Installation --lang, dann die Systemsprache, sonst Englisch. --yes ohne erkanntes KI-Werkzeug schreibt keine Adapter. uninstall akzeptiert -d/--directory.
-- Das npm-Paket enthält keine Veröffentlichungsskripte der Maintainer mehr. OSINT und Shield enthalten rechtliche Hinweise und kennzeichnen KI-generierte Ausgaben; Shadow wird als kontrollierte Recherche in öffentlichen Quellen beschrieben.
-- Die übersetzten READMEs spiegeln das öffentliche README, das einen Hinweis zur fehlenden Verbindung mit BMad Code, LLC und einen sachlichen Vergleich ergänzt. Die Website zeigt den Installationsbefehl direkt oben und bietet ein dunkles Farbschema.
+- bmad-plus review scope listet die seit dem Basis-Branch oder im Arbeitsverzeichnis geänderten Dateien, nennt für jede andere geänderte Datei den Grund des Ausschlusses (Geheimnis, binär, gelöscht, generiert), teilt die Arbeit in geordnete Einheiten und versiegelt alles mit einem Hash. Geheime Dateien werden vor jedem Einschlussmuster ausgeschlossen und kommen nie zurück.
+- Befunde stehen in findings.json und zitieren den betroffenen Code wörtlich. bmad-plus review anchor findet diesen Code in der Datei und meldet ein Zitat, das es nicht oder doppelt findet, statt einer Zeilennummer zu vertrauen. Eine unbekannte Kategorie oder Schwere wird abgelehnt, nie erraten.
+- bmad-plus review gate antwortet incomplete, findings oder clean. Ein Review bleibt unvollständig, solange eine ausgewählte Datei in coverage.json fehlt oder ein offener Befund nicht verankert ist; clean gilt nur für den geprüften Umfang.
+- Sentinel und der Dev-Studio-Workflow code-review behalten einen Befund standardmäßig und widerlegen ihn nur mit einem zitierten Grund: Der Code fehlt, der Code widerspricht ihm, oder er doppelt einen anderen Befund. Befunde zu Sicherheit, Datenverlust oder Geld ohne ein solches Zitat bleiben ungeklärt.
+- Das Maintainer-README nennt jetzt, was BMAD+ bewusst nicht tut: keine Modell-Laufzeit, keine Hintergrundprozesse, keine Review-Engine, die Befunde verschiebt, keine automatischen Korrekturen aus einem Review.
+- Die Veröffentlichungswerkzeuge akzeptieren das Ein-Element-Array, das npm jetzt bei Integritätsprüfungen liefert. Die Continuous Integration prüft, dass jede GitHub-Action von Dritten auf einen vollständigen Commit festgelegt ist.
 
 ## Versionsverlauf
 
@@ -196,10 +194,9 @@ Diese Daten bezeichnen geprüfte CHANGELOG-Einträge, nicht die Veröffentlichun
 
 | Version | Datum der Notizen | Geprüfte Zusammenfassung |
 | --- | --- | --- |
+| 0.19.0 | 2026-09-27 | bmad-plus review versiegelt, was ein Review abdecken muss, findet jeden Befund über den Code, den er zitiert, und leitet das Urteil aus der Abdeckung ab statt aus der Zahl der Befunde. Die Review-Sichtung behält einen Befund jetzt, solange kein zitierter Grund ihn widerlegt. An Installation und Update ändert sich nichts. |
+| 0.18.0 | 2026-09-25 | Die Abnahmeseite prüft jetzt jedes Speichern, stellt deine Antworten beim Neuladen vor allem anderen wieder her, hält Durchläufe anderer Fassungen und anderer Tabs auseinander und benennt sechzehn Garantien, die der Build nicht verlieren darf. An Installation und Update ändert sich nichts; baue deine Rezeptseiten neu, um die neue Seite zu erhalten. |
 | 0.17.1 | 2026-09-24 | Eine Installation über eine andere Version bricht jetzt ab und verweist auf update, eine erneute Installation behält deine Einstellungen, und Updates entfernen Dateien, die eine Version nicht mehr mitliefert, mit wiederherstellbarer Sicherung. Einige Installationsabläufe ändern sich: Prüfe deine Skripte, bevor du sie erneut ausführst. |
-| 0.17.0 | 2026-09-22 | Abnahmeseiten verhindern jetzt unbemerkt verlorene Antworten und leere Exporte. Rezepte lassen sich anhand ihrer Kennung erzeugen, und Veröffentlichungsprüfungen verwenden unter Windows direkt Node. Die Anleitungen ergänzen Prompts für die Ergebnisprüfung und die Sicherung des Projektkontexts. |
-| 0.16.0 | 2026-09-16 | Eine Lieferung erzeugt jetzt eine Schritt-für-Schritt-Seite, die eine Person durchgeht; ihr Durchlauf kommt als Nachweis zurück, den die Agenten lesen, einordnen und zur Prüfung machen. Diese Version bringt zusätzlich, was 0.15.0 vorbereitet, aber nie veröffentlicht hatte: dauerhafte Nexus-Ausführung, evidenzbasierte Speicherbewertung und bewertete Kontrollen für jedes Pack. |
-| 0.14.0 | 2026-09-09 | Dev Studio erhält vollständige Anweisungen und überprüfbares Laden des Kontexts; die Dokumentation folgt dem veröffentlichten Paket. |
 
 [Versionsverlauf und Update-Anleitung](https://bmad-plus.rochetta.fr/de/docs/#changelog) · [Alle veröffentlichten Versionen auf npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
 

package/readme-international/README.es.md

@@ -4,9 +4,9 @@
   <a href="../README.md">English</a> | <a href="README.fr.md">Français</a> | 🌐 <b>Español</b> | <a href="README.de.md">Deutsch</a>
 </div>
 
-[![Version](https://img.shields.io/badge/version-0.17.1-blue)](https://www.npmjs.com/package/bmad-plus)
+[![Version](https://img.shields.io/badge/version-0.19.0-blue)](https://www.npmjs.com/package/bmad-plus)
 
-**Versión 0.17.1** · Node.js `>=20.0.0` · MIT
+**Versión 0.19.0** · Node.js `>=20.0.0` · MIT
 
 Flujos de desarrollo con IA propios de cada proyecto, con roles claros, contexto compartido, actualizaciones seguras y adaptadores para herramientas de programación.
 
@@ -39,7 +39,7 @@ Ejecuta el instalador. Selecciona los adaptadores de tus herramientas de IA y lo
 **En la terminal del proyecto:**
 
 ```sh
-npx bmad-plus@0.17.1 install
+npx bmad-plus@0.19.0 install
 ```
 
 El instalador crea las instrucciones de los agentes, la base compartida y los adaptadores seleccionados. Algunos packs opcionales necesitan otros entornos o acceso a API.
@@ -75,7 +75,7 @@ Pide a Sentinel que compruebe el cambio según los criterios de aceptación. Sol
 **En tu asistente de IA:**
 
 ```text
-Sentinel, revisa este cambio según los criterios de aceptación. Comprueba los principales casos de éxito y fallo, informa de los problemas pendientes y resume lo que necesita saber la próxima sesión.
+Sentinel, revisa este cambio según los criterios de aceptación. Comprueba los principales casos de éxito y fallo, informa de los problemas pendientes y resume lo que necesita saber la próxima sesión. Si el CLI de BMAD+ está disponible, sella el alcance con bmad-plus review scope, cita el código de cada hallazgo, da cuenta de cada archivo seleccionado y comunica lo que responde bmad-plus review gate.
 ```
 
 Lee los cambios y los resultados de las pruebas. El asistente sigue los permisos y las capacidades de su herramienta anfitriona.
@@ -140,7 +140,7 @@ Resultado esperado: tareas delimitadas, dependencias explícitas y una revisión
 Úselo cuando una versión llegue a su entorno de pruebas y alguien deba comprobarla en pantalla.
 
 ```text
-Sentinel, escribe la receta de aceptación de esta entrega en nuestro entorno de pruebas. Un paso por gesto, un hecho verificable por línea, las etiquetas citadas desde el código y marca los pasos que escriben de verdad. Construye la página y dime el enlace, cuánto dura y qué no debo saltarme. Usa datos de prueba desechables cuando sea posible, indica la carpeta y los archivos que modifica cada comando y distingue las evidencias automáticas de las respuestas de la persona.
+Sentinel, escribe la receta de aceptación de esta entrega en nuestro entorno de pruebas. Un paso por gesto, un hecho verificable por línea, las etiquetas citadas desde el código y marca los pasos que escriben de verdad. Construye la página y dime el enlace, cuánto dura y qué no debo saltarme. Usa datos de prueba desechables cuando sea posible, indica la carpeta y los archivos que modifica cada comando y distingue las evidencias automáticas de las respuestas de la persona. Antes de entregarme la página, constrúyela con uat build, comprueba las garantías que enumera, recorre tú mismo el paso esencial en un navegador real —empezar, marcar, escribir una observación, recargar, todo vuelve— y dime qué comprobaciones se ejecutaron.
 ```
 
 Resultado esperado: una página que una persona no técnica puede recorrer y una prueba que el agente relee para clasificar cada fallo antes de corregir nada.
@@ -175,20 +175,18 @@ Lee AGENTS.md y la memoria de proyecto disponible. Resume el último estado veri
 
 Resultado esperado: una reanudación breve y fundamentada. Las notas aportan contexto que debe contrastarse con el trabajo actual.
 
-## Novedades de la 0.17.1
+## Novedades de la 0.19.0
 
-Instalaciones más seguras y actualizaciones más limpias
+Revisiones de código verificables
 
-Instalar sobre otra versión ahora se detiene y remite a update, una reinstalación conserva tus ajustes y las actualizaciones eliminan los archivos que una versión ya no incluye, con una copia restaurable. Algunos comportamientos de instalación cambian: revisa tus scripts antes de volver a ejecutarlos.
+bmad-plus review sella lo que una revisión debe cubrir, localiza cada hallazgo por el código que cita y deduce el veredicto de la cobertura en lugar del número de hallazgos. La clasificación de las revisiones conserva ahora un hallazgo mientras ningún motivo citado lo refute. Nada cambia en la instalación ni en la actualización.
 
-- install se niega a sobrescribir otra versión instalada. Volver a una versión anterior se rechaza; para pasar a una versión más reciente, ejecuta bmad-plus update, que conserva copias de seguridad y recibos restaurables. Reinstalar la misma versión solo añade los archivos que faltan.
-- Una reinstalación conserva los ajustes de _bmad/config.yaml y solo añade los valores predeterminados que faltan. El manifiesto y la configuración se escriben de forma atómica.
-- --packs y --tools se suman a la instalación anterior en lugar de sustituirla. Un identificador de paquete o de herramienta desconocido falla antes de escribir nada y muestra la lista de identificadores válidos.
-- update elimina los archivos sin modificar que la nueva versión ya no incluye, los guarda en el recibo de actualización y los restaura con --restore. Los archivos que editaste se conservan y se indican.
-- Un bloqueo de proyecto que dejó un proceso interrumpido se recupera automáticamente cuando consta que su proceso propietario ya no se ejecuta en esta máquina; doctor informa de los demás bloqueos caducados con la solución manual.
-- Sin terminal, la instalación usa --lang, después el idioma del sistema y, por último, el inglés. --yes sin ninguna herramienta de IA detectada no escribe adaptadores. uninstall acepta -d/--directory.
-- El paquete npm ya no incluye los scripts de publicación de los mantenedores. OSINT y Shield incluyen avisos legales y marcan el contenido generado por IA; Shadow se describe como investigación controlada en fuentes públicas.
-- Los README traducidos reflejan el README público, que añade un aviso de no afiliación y una comparación basada en hechos. La web muestra el comando de instalación desde la portada y ofrece un tema oscuro.
+- bmad-plus review scope enumera los archivos modificados desde la rama base o en tu árbol de trabajo, indica por qué se descarta cada otro archivo modificado (secreto, binario, eliminado, generado), divide el trabajo en lotes ordenados y lo sella con una huella. Los archivos secretos se descartan antes de cualquier patrón de inclusión y nunca vuelven.
+- Los hallazgos van en findings.json y citan literalmente el código al que se refieren. bmad-plus review anchor encuentra ese código en el archivo e informa de una cita que no encuentra, o que encuentra dos veces, en lugar de fiarse de un número de línea. Una categoría o gravedad desconocida se rechaza, nunca se adivina.
+- bmad-plus review gate responde incomplete, findings o clean. Una revisión sigue incompleta mientras falte un archivo seleccionado en coverage.json o un hallazgo abierto no esté anclado; clean solo cubre el alcance revisado.
+- Sentinel y el flujo code-review de Dev Studio conservan un hallazgo por defecto y solo lo refutan con un motivo citado: el código no está, el código lo contradice o duplica otro hallazgo. Un hallazgo de seguridad, pérdida de datos o dinero sin esa cita queda sin resolver.
+- El README de mantenimiento indica ahora lo que BMAD+ no hace a propósito: sin motor de modelos, sin procesos en segundo plano, sin revisión que reubique los hallazgos, sin correcciones automáticas a partir de una revisión.
+- Las herramientas de publicación aceptan la matriz de un elemento que npm devuelve ahora en las comprobaciones de integridad. La integración continua comprueba que cada acción de GitHub de terceros esté fijada a un commit completo.
 
 ## Historial de versiones
 
@@ -196,10 +194,9 @@ Estas fechas identifican las notas revisadas del CHANGELOG, no las fechas de pub
 
 | Versión | Fecha de las notas | Resumen revisado |
 | --- | --- | --- |
+| 0.19.0 | 2026-09-27 | bmad-plus review sella lo que una revisión debe cubrir, localiza cada hallazgo por el código que cita y deduce el veredicto de la cobertura en lugar del número de hallazgos. La clasificación de las revisiones conserva ahora un hallazgo mientras ningún motivo citado lo refute. Nada cambia en la instalación ni en la actualización. |
+| 0.18.0 | 2026-09-25 | La página de aceptación ahora verifica cada guardado, restaura tus respuestas al recargar antes que nada, mantiene separadas las pruebas de otras versiones y otras pestañas, y nombra dieciséis garantías que la construcción se niega a perder. Nada cambia en la instalación ni en la actualización; reconstruye tus páginas de receta para obtener la nueva página. |
 | 0.17.1 | 2026-09-24 | Instalar sobre otra versión ahora se detiene y remite a update, una reinstalación conserva tus ajustes y las actualizaciones eliminan los archivos que una versión ya no incluye, con una copia restaurable. Algunos comportamientos de instalación cambian: revisa tus scripts antes de volver a ejecutarlos. |
-| 0.17.0 | 2026-09-22 | Las páginas de aceptación evitan la pérdida silenciosa de respuestas y las exportaciones vacías. Las recetas se generan por su identificador y los controles de publicación usan Node directamente en Windows. Las guías añaden prompts para revisar resultados y conservar el contexto del proyecto. |
-| 0.16.0 | 2026-09-16 | Una entrega produce ahora una página paso a paso que una persona recorre, y su prueba vuelve como evidencia que los agentes leen, clasifican y convierten en control. Esta versión incluye además lo que preparó la 0.15.0 sin llegar a publicarse: ejecución Nexus persistente, memoria clasificada por evidencias y controles puntuados de cada paquete. |
-| 0.14.0 | 2026-09-09 | Dev Studio incorpora instrucciones completas y carga verificable del contexto; la documentación sigue al paquete publicado. |
 
 [Historial de versiones y guía de actualización](https://bmad-plus.rochetta.fr/es/docs/#changelog) · [Todas las versiones publicadas en npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
 

package/readme-international/README.fr.md

@@ -4,9 +4,9 @@
   <a href="../README.md">English</a> | 🌐 <b>Français</b> | <a href="README.es.md">Español</a> | <a href="README.de.md">Deutsch</a>
 </div>
 
-[![Version](https://img.shields.io/badge/version-0.17.1-blue)](https://www.npmjs.com/package/bmad-plus)
+[![Version](https://img.shields.io/badge/version-0.19.0-blue)](https://www.npmjs.com/package/bmad-plus)
 
-**Version 0.17.1** · Node.js `>=20.0.0` · MIT
+**Version 0.19.0** · Node.js `>=20.0.0` · MIT
 
 Des workflows de développement IA propres à chaque projet, avec des rôles clairs, un contexte partagé, des mises à jour sûres et des adaptateurs pour vos outils de code.
 
@@ -39,7 +39,7 @@ Lancez l’installateur. Sélectionnez les adaptateurs de vos outils IA et les p
 **Dans le terminal du projet :**
 
 ```sh
-npx bmad-plus@0.17.1 install
+npx bmad-plus@0.19.0 install
 ```
 
 L’installateur crée les instructions des agents, le socle partagé et les adaptateurs sélectionnés. Certains packs facultatifs nécessitent d’autres environnements ou des accès API.
@@ -75,7 +75,7 @@ Demandez à Sentinel de contrôler le changement selon les critères d’accepta
 **Dans votre assistant IA :**
 
 ```text
-Sentinel, relis ce changement selon les critères d’acceptation. Vérifie les principaux cas de réussite et d’échec, signale les problèmes restants et résume ce que la prochaine session doit savoir.
+Sentinel, relis ce changement selon les critères d’acceptation. Vérifie les principaux cas de réussite et d’échec, signale les problèmes restants et résume ce que la prochaine session doit savoir. Si le CLI BMAD+ est disponible, scelle le périmètre avec bmad-plus review scope, cite le code de chaque remarque, rends compte de chaque fichier retenu, puis rapporte ce que répond bmad-plus review gate.
 ```
 
 Relisez les changements et les résultats des tests. L’assistant suit les autorisations et les capacités de son outil hôte.
@@ -140,7 +140,7 @@ Résultat attendu : des missions délimitées, des dépendances explicites et un
 À utiliser quand une version arrive sur votre environnement de test et que quelqu’un doit la vérifier à l’écran.
 
 ```text
-Sentinel, écris la recette de cette livraison sur notre environnement de test. Une étape par geste, un fait vérifiable par ligne, les libellés cités depuis le code, et signale les étapes qui écrivent pour de vrai. Fabrique la page, puis donne-moi le lien, la durée et ce que je ne dois pas sauter. Utilise si possible des données d’essai jetables, nomme le dossier et les fichiers que chaque commande modifie, et distingue les preuves automatisées des réponses de la personne.
+Sentinel, écris la recette de cette livraison sur notre environnement de test. Une étape par geste, un fait vérifiable par ligne, les libellés cités depuis le code, et signale les étapes qui écrivent pour de vrai. Fabrique la page, puis donne-moi le lien, la durée et ce que je ne dois pas sauter. Utilise si possible des données d’essai jetables, nomme le dossier et les fichiers que chaque commande modifie, et distingue les preuves automatisées des réponses de la personne. Avant de me remettre la page, construis-la avec uat build, vérifie les garanties qu’elle liste, joue toi-même le passage essentiel dans un vrai navigateur — démarrer, cocher, écrire une remarque, recharger, tout revient — et dis-moi quels contrôles ont tourné.
 ```
 
 Résultat attendu : une page qu’une personne non technique peut jouer, et un passage que l’agent relit pour classer chaque échec avant toute correction.
@@ -175,20 +175,18 @@ Lis AGENTS.md et la mémoire de projet disponible. Résume le dernier état vér
 
 Résultat attendu : une reprise courte et fondée sur des éléments vérifiés. Les notes apportent du contexte, à confronter au travail actuel.
 
-## Nouveautés de la 0.17.1
+## Nouveautés de la 0.19.0
 
-Des installations plus sûres et des mises à jour plus propres
+Des revues de code vérifiables
 
-Installer par-dessus une autre version s’arrête désormais et renvoie vers update, une réinstallation conserve vos réglages, et les mises à jour retirent les fichiers qu’une version ne livre plus en gardant une sauvegarde restaurable. Certains comportements d’installation changent : vérifiez vos scripts avant de les relancer.
+bmad-plus review scelle ce qu’une revue doit couvrir, retrouve chaque remarque par le code qu’elle cite, et déduit le verdict de la couverture plutôt que du nombre de remarques. Le tri des revues garde désormais une remarque tant qu’un motif cité ne la réfute pas. Rien ne change dans l’installation ou la mise à jour.
 
-- install refuse d’écraser une autre version installée. Revenir à une version antérieure est refusé ; pour passer à une version plus récente, lancez bmad-plus update, qui conserve des sauvegardes et des reçus restaurables. Réinstaller la même version ajoute seulement les fichiers manquants.
-- Une réinstallation conserve les réglages de _bmad/config.yaml et n’ajoute que les valeurs par défaut manquantes. Le manifeste et la configuration sont écrits de façon atomique.
-- --packs et --tools s’ajoutent à l’installation précédente au lieu de la remplacer. Un identifiant de pack ou d’outil inconnu échoue avant toute écriture et affiche la liste des identifiants valides.
-- update supprime les fichiers non modifiés que la nouvelle version ne livre plus, les sauvegarde dans le reçu de mise à jour et les restaure avec --restore. Les fichiers que vous avez modifiés sont conservés et signalés.
-- Un verrou de projet laissé par un processus interrompu est repris automatiquement lorsqu’il est établi que son processus propriétaire ne tourne plus sur cette machine ; doctor signale les autres verrous périmés avec la marche à suivre.
-- Sans terminal, l’installation utilise --lang, puis la langue du système, puis l’anglais. --yes sans outil IA détecté n’écrit aucun adaptateur. uninstall accepte -d/--directory.
-- Le paquet npm n’inclut plus les scripts de publication des mainteneurs. OSINT et Shield comportent des avertissements juridiques et signalent les contenus générés par IA ; Shadow est présenté comme une recherche encadrée en sources publiques.
-- Les README traduits reflètent le README public, qui ajoute une mention de non-affiliation et une comparaison factuelle. Le site affiche la commande d’installation dès l’accueil et propose un thème sombre.
+- bmad-plus review scope liste les fichiers modifiés depuis la branche de base ou dans votre arbre de travail, dit pourquoi chaque autre fichier modifié est écarté (secret, binaire, supprimé, généré), découpe le travail en lots ordonnés et scelle le tout par une empreinte. Les fichiers secrets sont écartés avant tout motif d’inclusion et ne reviennent jamais.
+- Les remarques vont dans findings.json et citent mot pour mot le code qu’elles visent. bmad-plus review anchor retrouve ce code dans le fichier et signale une citation introuvable, ou trouvée deux fois, au lieu de se fier à un numéro de ligne. Une catégorie ou une sévérité inconnue est refusée, jamais devinée.
+- bmad-plus review gate répond incomplete, findings ou clean. Une revue reste incomplète tant qu’un fichier retenu manque dans coverage.json ou qu’une remarque ouverte n’est pas ancrée ; clean ne couvre que le périmètre revu.
+- Sentinel et le workflow code-review de Dev Studio gardent une remarque par défaut et ne la réfutent que sur un motif cité : le code est absent, le code la contredit, ou elle en double une autre. Une remarque sur la sécurité, la perte de données ou l’argent sans cette citation reste non résolue.
+- Le README mainteneur dit désormais ce que BMAD+ ne fait pas, volontairement : pas de moteur de modèle, pas de processus d’arrière-plan, pas de revue qui repositionne les remarques, pas de correctif automatique issu d’une revue.
+- Les outils de publication acceptent le tableau à un élément que npm renvoie désormais pour les contrôles d’intégrité. L’intégration continue vérifie que chaque action GitHub tierce est épinglée sur un commit complet.
 
 ## Historique des versions
 
@@ -196,10 +194,9 @@ Ces dates identifient les notes relues du CHANGELOG, pas les dates de publicatio
 
 | Version | Date des notes | Résumé relu |
 | --- | --- | --- |
+| 0.19.0 | 2026-09-27 | bmad-plus review scelle ce qu’une revue doit couvrir, retrouve chaque remarque par le code qu’elle cite, et déduit le verdict de la couverture plutôt que du nombre de remarques. Le tri des revues garde désormais une remarque tant qu’un motif cité ne la réfute pas. Rien ne change dans l’installation ou la mise à jour. |
+| 0.18.0 | 2026-09-25 | La page de recette vérifie désormais chaque enregistrement, restaure vos réponses au rechargement avant toute autre chose, distingue les passages d’autres révisions et d’autres onglets, et nomme seize garanties que la construction refuse de perdre. Rien ne change dans l’installation ou la mise à jour ; reconstruisez vos pages de recette pour obtenir la nouvelle page. |
 | 0.17.1 | 2026-09-24 | Installer par-dessus une autre version s’arrête désormais et renvoie vers update, une réinstallation conserve vos réglages, et les mises à jour retirent les fichiers qu’une version ne livre plus en gardant une sauvegarde restaurable. Certains comportements d’installation changent : vérifiez vos scripts avant de les relancer. |
-| 0.17.0 | 2026-09-22 | Les pages de recette empêchent désormais la perte silencieuse des réponses et les exports vides. Une recette se construit avec son identifiant, et les contrôles de publication utilisent directement Node sous Windows. Les guides ajoutent des prompts pour relire les résultats et conserver le contexte du projet. |
-| 0.16.0 | 2026-09-16 | Une livraison produit désormais une page pas à pas qu’une personne joue, et son passage revient comme une preuve que les agents lisent, classent et transforment en porte. Cette version emporte aussi ce que la 0.15.0 avait préparé sans jamais être publiée : l’exécution Nexus persistante, la mémoire classée par preuves et les contrôles notés de chaque pack. |
-| 0.14.0 | 2026-09-09 | Dev Studio reçoit des instructions complètes et un chargement vérifiable du contexte ; la documentation suit le paquet publié. |
 
 [Historique des versions et guide de mise à jour](https://bmad-plus.rochetta.fr/fr/docs/#changelog) · [Toutes les versions publiées sur npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
 

package/src/bmad-plus/agents/agent-quality/SKILL.md

@@ -60,9 +60,10 @@ When auto-activating a role, **announce it**: "💡 I'm switching to [Role] mode
 1. Establish the intended behavior, review scope and current artifact set. Read relevant project instructions, callers, tests and requirements. Treat the author's summary and worker completion messages as claims to check, not acceptance evidence. Inspect removed behavior and reachable failure paths where the change makes them relevant.
 2. Select only the review perspectives the task needs. When independent reviewers are authorized and available, give each the same baseline and a bounded question; launch the selected reviewers before using their findings to steer another review. Preserve their identities and returned evidence. Otherwise identify sequential perspectives as one assistant's work. An absent, failed or empty required response is incomplete; distinguish it from an explicit no-findings result after inspection.
 3. Verify each suspected issue before grouping findings. Trace its trigger through the actual caller and guards, inspect counterevidence, and reproduce it when practical. A failure in an unreachable state is not an established defect. Check every source, including a reviewer that describes its own findings as pre-verified.
-4. Keep a compact finding record with identity, source, location, claimed consequence, evidence or refutation, disposition, relevant input identity and next action. Use confirmed, refuted or unresolved; rank confirmed defects by impact and likelihood. Preserve previous entries when their disposition changes. Group confirmed findings only when the same cause explains them, retaining each source record. Do not merge away a refutation or impose a finding quota.
+4. Keep a compact finding record with identity, source, location, claimed consequence, evidence or refutation, disposition, relevant input identity and next action. The default disposition is keep: refute only on a quoted ground — the described construct is absent from the file, the code contradicts the claim (guard, caller or test quoted), or another entry already carries the same cause — and write the analysis before the disposition. A security, data-loss or money finding without such a quote stays unresolved. Use confirmed, refuted or unresolved; rank confirmed defects by impact and likelihood. Preserve previous entries when their disposition changes. Group confirmed findings only when the same cause explains them, retaining each source record. Do not merge away a refutation or impose a finding quota.
 5. Inspect verification at the actual consumer. Read assertions and check how tests are selected before judging their coverage. Search relevant symbols and imports before asserting that coverage is absent. For a verification gap, name the consumer and a concrete regression or missed adoption that the current checks would fail to catch. Skipped tests, mocks that bypass the changed path and helper-only success do not prove that consumer works.
-6. Reconcile acceptance using executed commands or direct observations against the current artifact set. Record passed, failed, skipped and unavailable checks separately. A missing required reviewer or untested criterion prevents a completed-acceptance claim, even when the remaining checks pass. A same-author review must not be described as independent verification.
+6. When the BMAD+ CLI is available, back a code review with its evidence: `bmad-plus review scope <id>` before reading, then `findings.json` with every finding quoting its code verbatim and `coverage.json` accounting for every selected file, then `bmad-plus review anchor <id>` and `bmad-plus review gate <id>`. Report the gate's disposition (incomplete, findings or clean) without upgrading it.
+7. Reconcile acceptance using executed commands or direct observations against the current artifact set. Record passed, failed, skipped and unavailable checks separately. A missing required reviewer or untested criterion prevents a completed-acceptance claim, even when the remaining checks pass. A same-author review must not be described as independent verification.
 
 ## Repair and continuation
 

package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md

@@ -8,6 +8,21 @@ For each suspected issue, inspect the supporting code and counterevidence. Remov
 duplicates and distinguish a behavioral defect from a style preference. Retain
 the reason a suspicion was refuted so continuation does not repeat it.
 
+Refutation protocol. The default disposition is keep: removing a correct finding
+costs more than keeping a wrong one. A finding moves to refuted only on one of
+three citable grounds, and the citation goes into the record:
+
+- **A — absent**: the construct the finding describes is not in the subject file;
+  quote what the file contains at that place.
+- **B — contradicted**: the code refutes the claim; quote the guard, caller or
+  test that makes the failure unreachable.
+- **C — duplicate**: another retained entry describes the same cause; name it.
+
+Write the analysis before the disposition. Findings on security, data loss,
+money or access control need ground A or B quoted; without it they stay
+unresolved, never refuted. "Unlikely", "probably handled" and style disagreement
+are not grounds.
+
 A retained finding needs a file/line, trigger, consequence, evidence, confidence
 and proportionate fix direction. Set severity from actual impact and likelihood.
 Unsupported speculation belongs in open questions.

package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md

@@ -17,9 +17,14 @@ arbitrary branch. Read the intended behavior and applicable project constraints.
 
 ## Procedure
 
-1. Define the review scope and baseline. Inventory changed paths, related callers,
-   tests and requirements. Preserve existing edits and record unavailable context.
-   A supplied diff may omit the surrounding behavior needed to evaluate it.
+1. Define the review scope and baseline. When the BMAD+ CLI is available, seal it:
+   `bmad-plus review scope <id> --base <ref>` (or `--workspace` for uncommitted
+   work) writes `_bmad-output/review/<id>/scope.json` with every selected file,
+   every excluded file and its reason (secret, binary, deleted, generated), and
+   ordered review units. Never read or quote an excluded secret file. Inventory
+   related callers, tests and requirements. Preserve existing edits and record
+   unavailable context. A supplied diff may omit the surrounding behavior needed
+   to evaluate it.
 2. Review the intended behavior, invariants and relevant failure boundaries.
    Check control flow, data changes, interface compatibility and test assertions.
    Add concurrency, permissions, input validation, recovery or UX perspectives
@@ -34,7 +39,14 @@ arbitrary branch. Read the intended behavior and applicable project constraints.
    practical and within the task. Do not alter product code during a review
    unless fixes are also authorized.
 5. Triage the results. Remove duplicates, distinguish defects from preferences,
-   and retain the reason when a suspicion is refuted. For a retained issue,
+   and retain the reason when a suspicion is refuted. Keep a finding by default:
+   deleting a real defect costs more than keeping a doubtful one. Refute it only
+   on a citable ground — (A) the construct it describes is absent from the file,
+   quoted from the file; (B) the claim contradicts the code, the named guard or
+   caller quoted; (C) it is a duplicate, the surviving entry named. Write the
+   analysis before the disposition. A finding on security, data loss or money
+   that meets none of these grounds stays unresolved, never refuted by judgment.
+   Doubt and taste are not grounds. For a retained issue,
    provide file/line, trigger, consequence, supporting evidence, confidence and a
    proportionate fix direction. Severity follows impact and likelihood, not tone.
 6. Reconcile acceptance coverage and review limitations. Record checks actually
@@ -43,6 +55,15 @@ arbitrary branch. Read the intended behavior and applicable project constraints.
 7. Deliver findings in impact order, followed by the scoped conclusion and
    evidence limits. Zero findings is valid after inspection; it means no
    actionable defect was found within that reviewed scope.
+8. With a sealed scope, record the evidence the CLI can check, in the same folder:
+   `findings.json` (`bmad-plus/review-findings/1`: every finding, refuted ones
+   included, each quoting `existing_code` verbatim from the file — never a line
+   number) and `coverage.json` (`bmad-plus/review-coverage/1`: every selected file
+   as completed, failed or waived with a reason). Run `bmad-plus review anchor <id>`
+   and requote any finding it reports ambiguous or unlocated; then
+   `bmad-plus review gate <id>`. Report its disposition as it is: `incomplete`
+   when a selected file is unaccounted for or a finding is not anchored, `findings`
+   or `clean` otherwise. `clean` covers the reviewed scope only.
 
 ## Output and acceptance