lightsoutAlpha

per-folder-readmes

a folder README restating structure these rules already give

Agent checkadvisory by defaultbasecode

The argument

Per-Folder READMEs

A folder gets a README.md only for a genuine invariant not derivable from these rules (e.g. "everything here runs in the widget sandbox — no DOM globals"). Never prose restating the structure.

The proof

fail
export const getCharge = () => 1;
pass
Everything here runs in the widget sandbox — no DOM globals.

Turn it down

Both lines go in your lightsout.config.json.

"standards-checks": { "per-folder-readmes": "advisory" }
"standards-checks": { "per-folder-readmes": "off" }