chore: correct the review agents' briefs and add a Phase 5 minifier check
Separated from the step 1 feature commit on adversarial-reviewer's own recommendation: instructions that narrow a reviewer's scope should not travel in the same commit as the work that reviewer is checking. claims-auditor.md — REMOVE the enumerated membership list. It read "ADRIC, ADRIO, OBA sections only" while AGENTS.md §4 had gained the Canadian Tax Foundation that morning, so the auditor's own brief contradicted the register: it would have flagged a verified membership as unverified and would not have noticed CTF being dropped. This file has now hosted a stale claim twice. Replaced with an instruction to read the §4 row at audit time — a copy of a fact goes stale where nobody re-reads it. adversarial-reviewer.md — state that Lighthouse cannot be run until step 7 and that its absence is not a finding (AGENTS.md §7, R11). Repair a sentence left truncated mid-list. Caveat the "~1 MB of logo PNGs" figure against Q34, which is open on it. build.md — Phase 4 now carries the measurement that justifies the re-review requirement: on the Astro 5→7 upgrade four of six second-round findings were defects in the first round's own fixes. Phase 5 gains a grep asserting no `animation` shorthand beside `animation-timeline` survives into dist — Lightning CSS folds them into an invalid declaration that works in dev and is dead in the build. That happened twice in one session, the second time inside the fix for the first. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012XquaEq4BgWMCwUqLEyNkF
This commit is contained in:
co-authored by
Claude Opus 5
parent
7514a49803
commit
8f1df2c27c
@@ -61,6 +61,14 @@ so a later reader can see the judgement was made rather than missed.
|
||||
If you fix anything material, **re-run Phase 3 on the fix.** A patch written
|
||||
under review pressure is exactly where the second defect lives.
|
||||
|
||||
> **This is not ceremony, and here is the measurement.** On the Astro 5 → 7
|
||||
> upgrade (`AGENTS.md` entry (t), 2026-08-26) the second review pass returned
|
||||
> six findings. **Four of the six were defects in the first round's own fixes** —
|
||||
> including a date validator whose replacement silently rolled `2026-02-30`
|
||||
> forward to `2026-03-02`, and a title rule whose fix rejected all five planned
|
||||
> launch articles. None of the four existed before the review started. Skip the
|
||||
> re-review and you ship the repair, not the bug.
|
||||
|
||||
## Phase 5 — Verify — run it, do not assert it
|
||||
|
||||
```bash
|
||||
@@ -73,9 +81,22 @@ Then, as applicable to what changed:
|
||||
- Serve `dist/` and confirm the page **renders its full content with JavaScript
|
||||
disabled** — the failure this whole project exists to fix
|
||||
- `curl` the built HTML and confirm real content, not a shell
|
||||
- Lighthouse mobile ≥ 95 on all four categories
|
||||
- ~~Lighthouse mobile ≥ 95 on all four categories~~ — **UNAVAILABLE.**
|
||||
`@lhci/cli` was removed on 2026-08-26 and is not re-added until build step 7
|
||||
(`AGENTS.md` R11, §7). Report it as *not run, tool unavailable*. Do not
|
||||
substitute a manual DevTools run and describe it as the same check
|
||||
- Every internal link resolves
|
||||
- Metadata present: unique title, description, canonical, OG, JSON-LD
|
||||
- **No scroll-driven animation was eaten by the minifier.** This must return
|
||||
nothing:
|
||||
|
||||
```bash
|
||||
grep -rE 'animation:[^;}]*(scroll\(\)|view\(\))' dist --include='*.css'
|
||||
```
|
||||
|
||||
A hit means an `animation` shorthand was written beside `animation-timeline`
|
||||
and Lightning CSS folded them into an invalid declaration, which the parser
|
||||
then discards. The effect works in `npm run dev` and is dead in the build.
|
||||
|
||||
**Never report a check as passing that you did not run.** "Should pass" is not a
|
||||
result. If you could not run something, say which and why.
|
||||
|
||||
Reference in New Issue
Block a user