pruff-skills 0.12.0 → 0.13.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pruff-skills",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "description": "The official Pruff agent skills CLI",
5
5
  "type": "module",
6
6
  "bin": {
@@ -50,6 +50,24 @@ don't guess which one they mean.
50
50
  `light` structurally cannot check it. Pass `--standard` for those, and for anything
51
51
  touching schema, auth, money, or concurrency. Go to `--deep` only if a human asks in
52
52
  `#pr-review` — never on your own initiative.
53
+
54
+ **The page must come out of the skill's `template.html`. You never author the HTML
55
+ yourself.** This has already gone wrong in production: a review shipped a dossier with
56
+ invented sections (`Historia`, `Traza end-to-end`, `Cobertura`), an invented mode label
57
+ (`escalated deep-trace (fuera de light/deep)`), drift headlined instead of in the
58
+ collapsed appendix, and **every mermaid diagram rendered as raw text** — because a
59
+ hand-written page has none of `template.html`'s load-bearing ESM import and
60
+ render-then-hide ordering. Three checks before you report:
61
+ - The headings are the template's facets, filled from its `{{...}}` placeholders — not
62
+ a structure you designed.
63
+ - The mode you passed is one of `--light` / `--standard` / `--deep`. If you needed
64
+ something else, you needed `--deep`.
65
+ - Open the output and confirm the diagrams actually rendered. A visible `flowchart TD`
66
+ in a code block means the page is broken; fix it or report without it.
67
+
68
+ If the skill fails or is not installed, **say so and report your findings as plain
69
+ text.** A look-alike page you wrote yourself is worse than no page: it reads as
70
+ verified when nothing verified it.
53
71
  4. **Comment the dossier on the PR.** The skill reports a markdown dossier and a link to
54
72
  an interactive HTML version. **Post the markdown as the comment body** — that is the
55
73
  durable record. Then add the link on its own last line, with the absolute expiry date