docs(conjure): capture per visual slice, guard against redesigning around a frame

[SunkenInTime]

Skill changes that follow from the render-loop cadence experiment (20 agents, Opus and gpt-6-astra, three capture cadences, blind-graded). Edits skills/conjure-widget/SKILL.md at its path on master.

Changes

1. Render loop cadence. Was "after each edit that can change pixels". Now: after the first coherent slice, after each added visual region, and after any edit that changes semantics or interaction; one pass after the last edit is enough when the user is not watching the desktop. Rationale: progressive capture tied on final quality with final-only in both models (17.25 vs 17.6 of 18, inside noise) and cost zero to 40% more wall time, while producing 7 to 11 rendered saves per widget instead of 4. That is the visible build the Live loop wants, produced honestly.
2. The final pass is never optional, PNG opened and snapshot read. The one broken widget in twenty (letters drawn under counts) passed weaver check, both receipts, and every semantic gate with 7/10 self-confidence.
3. Guard against redesigning around a frame. Both models' lowest-scoring capturing run saw something mid-build and changed the spec item to match: a tick meter instead of a bar, a shrunken title to match date metrics. The skill now says fix what contradicts the request or the contract, and report renderer behavior that contradicts the contract as a framework reproduction while keeping the requested design.
4. Legibility floor. Seven of eight agents who looked raised secondary text to /45 or above. Stated at the inspection step.
5. Invocation. weaver … on PATH after npm run link (see chore(cli): put weaver on PATH and scope the package name #82), with the caveat that npx --no-install weaver works only inside the repository tree. Several agents lost calls to that npm error and read it as a widget problem.

Note for Dara

Your working tree has an uncommitted move of this file to .agents/skills/conjure-widget/SKILL.md plus an added examples list. This PR edits the master path so it applies cleanly to master; when you commit the move, the same seven replacements apply to the new path (they are all string-exact and live in experiments/render-loop-cadence/ history if you want them as a script).

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

[greptile-apps]

Greptile Summary

This change updates the Conjure widget-authoring guide to use direct CLI commands, capture coherent visual milestones, inspect final PNG and semantic evidence, preserve requested designs when renderer output conflicts with the contract, and improve dark-surface text legibility.

Do not merge as written: the guide tells authors to run npm run link, but that command is not defined in the repository and exits before the direct weaver workflow can begin. The documented capture command was verified to parse and route correctly, and capture was verified to reject incomplete output rather than reporting success without both required artifacts.

Confidence Score: 4/5

The guide is not ready to merge because its required CLI setup command fails immediately.

The broken command was reproduced from the repository root and the package manifest confirms that the referenced script is absent. Focused executions also confirmed that the capture command accepts the documented arguments and that incomplete capture artifacts cannot be published as success. A full native desktop capture was unavailable on Linux because the native runtime executable was not built, but the artifact-missing failure path was exercised through the CLI.

Files Needing Attention: skills/conjure-widget/SKILL.md needs a supported command for exposing weaver on PATH. package.json is the manifest that currently lacks the documented script.

T-Rex Logs

What T-Rex did

• T-Rex generated proof for two posted P1 findings and linked them to their corresponding review comments.
• T-Rex built and ran the documented weaver capture path at both the parent and current revisions, and verified the commands reached the CaptureRuntimeNotBuilt response.
• T-Rex exercised the capture path that intentionally omitted required output artifacts, and the CLI produced an error with no PNG, snapshot, or receipt published; publication rollback tests passed.
• T-Rex examined the weaver-link workflow logs and CLI behavior, including the before/after logs and the direct CLI path on Linux, to validate documented expectations and script declarations.
• T-Rex ran clock capture tests before and after, plus a negative control, to show the parser fails gracefully and that the environment lacks the native runtime needed for rendering.

_{Ran code and verified through T-Rex}

Comments Outside Diff (1)

1. General comment

   SKILL.md documents a nonexistent npm run link command

   • Bug
     • skills/conjure-widget/SKILL.md:9-12 tells users that npm run link in the Weaver repository puts weaver on PATH. From the repository root, npm run link returns npm error Missing script: "link" and exits 1. The root manifest's scripts block (package.json:13-20) contains no link entry. This prevents users from completing the documented global/direct weaver … setup step.
   • Cause
     • The documentation refers to a root npm script that is absent from the root package manifest.
   • Fix
     • Either add a root link script that performs the intended CLI linking, or replace the documented command with the repository-supported linking/install command and verify it makes weaver available on PATH.

   _{Ran code and verified through T-Rex}

_{Reviews (1): Last reviewed commit: "docs(conjure): capture per visual slice,..." | Re-trigger Greptile}

[greptile-apps]

Documented setup command does not exist

The workflow says npm run link makes weaver available on PATH, but the root package.json has no link script. Running that documented command exits with Missing script: "link", so authors cannot complete the prescribed setup before using weaver init, dev, check, or capture. Document a supported linking command or add the missing script.

_{Ran code and verified through T-Rex}