Development

Development

Layout

• skills/brandwright/scripts/bw.py: the CLI. It holds kit, tokens, prep, caption, train, score and sheet, and imports:
  • bw_browser.py: Playwright login, capture and render;
  • bw_comfy.py: ComfyUI gen, sweep and ref.
• Four skills, each with evergreen companions: RESEARCH, CHANGELOG, LEARNINGS, TESTS, MAINTENANCE, evergreen.json and evals/evals.json.
• tests/test_bw.py: offline tests. tests/smoke_browser.py: browser smoke test on the fictional fixture site in tests/fixtures/site/.
• scripts/budget.py: the size budget. scripts/check_public.py: no local paths, private addresses or kit files.
• evals/: trigger, decoy and action cases for claude plugin eval.
• ai-docs/: research, decisions, handoff and log.

Checks

python tests/test_bw.py
python tests/smoke_browser.py --channel msedge
python scripts/budget.py
python scripts/check_public.py

CI runs the suite on Windows, macOS and Linux with Python 3.10 and 3.14, the browser smoke test with Playwright's Chromium, and both guards.

Rules

• Never commit a kit, a screenshot of a real company site, a trained LoRA, a login profile or a caption written from one.
• The CLI uses the standard library only. Playwright and Pillow are optional imports.
• Every CLI change gets a test. Every masking change gets a smoke-test check.
• Model and licence facts carry a date and a source.

Releases

A release bumps the version in all of these together:

• .claude-plugin/plugin.json and plugin.json;
• VERSION in bw.py;
• metadata.version in every SKILL.md;
• version in every evergreen.json.

Then tag vX.Y.Z and publish a GitHub Release with the CHANGELOG entry as notes.