Context
Follows from #1030 (loop-grill skill). The external resources step (step 5a) covers links, other repos, and API access. This issue extends it to visual resources: screenshots and programmatic UI navigation.
Problem
Design-level grilling often requires visual understanding. A spec for a UI change is underspecified without seeing the current screen. Text descriptions of "click Settings → Profile → Edit" are ambiguous and error-prone. Grilling without visual context produces low-confidence answers on UX-facing questions.
Proposed solution
Extend the loop-grill external resources step to accept:
-
Screenshots — static image files or URLs attached to the issue/plan. The grill reads them as visual context when filling gaps that involve UI or design.
-
Playwright navigation descriptors — a structured description of how to reach a screen (e.g. "go to /settings, click Edit Profile"). In --auto mode, the grill can drive a headless browser to capture the current state of that screen and use the screenshot as context, rather than consuming tokens on a prose re-description.
The key constraint from #1030: no raw token consumption for resource fetching — route through bounded wrapper commands/tools (the Playwright runner would be a wrapper, not inline browser code).
Acceptance criteria
Non-goals
- Full visual regression testing
- Replacing Playwright tooling — this wraps an existing runner
- Automatically detecting that a spec needs visual context (follow-on)
References
Context
Follows from #1030 (loop-grill skill). The external resources step (step 5a) covers links, other repos, and API access. This issue extends it to visual resources: screenshots and programmatic UI navigation.
Problem
Design-level grilling often requires visual understanding. A spec for a UI change is underspecified without seeing the current screen. Text descriptions of "click Settings → Profile → Edit" are ambiguous and error-prone. Grilling without visual context produces low-confidence answers on UX-facing questions.
Proposed solution
Extend the loop-grill external resources step to accept:
Screenshots — static image files or URLs attached to the issue/plan. The grill reads them as visual context when filling gaps that involve UI or design.
Playwright navigation descriptors — a structured description of how to reach a screen (e.g.
"go to /settings, click Edit Profile"). In--automode, the grill can drive a headless browser to capture the current state of that screen and use the screenshot as context, rather than consuming tokens on a prose re-description.The key constraint from #1030: no raw token consumption for resource fetching — route through bounded wrapper commands/tools (the Playwright runner would be a wrapper, not inline browser code).
Acceptance criteria
--automode the grill invokes a bounded wrapper to capture the screenloop-grillskill for issue/plan clarification #1030)unresolved(same degradation rule as other external resources)Non-goals
References
loop-grillskill for issue/plan clarification #1030 (loop-grill)loop-grillskill for issue/plan clarification #1030, step 5a