[kyleve]

Posted by an AI agent on kve's behalf.

Summary

Use the repository's pinned Astro dependency for authorized interactive browser prototypes. The planning skill now routes prototype planning and execution to a focused reference covering watched source files, local-network previews, and the running-server handoff.

The procedure reuses the root dependency tree and Astro's native background/status/logs/stop commands, using an absolute project root for background launch. It requires checking actual automatic updates, the running port, and the machine’s current LAN address with a fresh HTTP response, and recording whether source edits reset the sample session. Physical-device verification stays distinct from a host request to its own LAN address.

This changes prototype workflow guidance only. Planning authorization, experiment acceptance, and the eventual app's architecture keep their existing boundaries. The Mobius application of the workflow is maintained separately in #500; this PR is independently based on main.

Verification

• mise exec ruby -- ./sync-agents and mise exec ruby -- ./sync-agents --check: pass; instruction budgets, skill discovery and canonical/Claude links validate.
• quick_validate.py .agents/skills/planning using the skill-creator validator: pass.
• Pinned Astro commands were exercised on the Mobius migration in feat(Mobius): prototype grouped review workspaces #500: check/build, background lifecycle, LAN access, and CSS/markup/client-script automatic updates. CSS retains the in-memory session; markup/script changes reload it. Independent coordinator UI checks pass in Chromium and WebKit on localhost/desktop and LAN/phone-sized views. Actual physical-phone access remains unverified.
• The runtime probe exposed relative roots being resolved twice by the background launcher. The documented absolute root starts successfully; installed CLI help confirms the lifecycle flags.
• A final handoff check found that Astro retained its printed startup network address after the Mac’s interface address changed. The server remained reachable at the current address; the guidance now requires verifying that address at handoff rather than trusting cached output.
• Reviewed the three-file guidance diff for conditional loading, command scope, preserved authorization, and server ownership; git diff --check passes. Native tests and SwiftFormat are outside this Markdown change.