Skip to content

AGENTS.md

Latest commit

 

History

History
10 lines (8 loc) · 1.15 KB

AGENTS.md

File metadata and controls

10 lines (8 loc) · 1.15 KB
Raw

scripts/AGENTS.md

These rules apply to scripts/**. Follow the repo-root AGENTS.md first, then use this file for automation and workflow helpers.

  • Keep scripts non-interactive and idempotent. Print the command, URL, branch, or path being acted on so failures are diagnosable.
  • Use repo-relative paths and environment variables instead of user-specific absolute paths.
  • For dev-server helpers, default to https://bitsocial.localhost, but allow a branch-scoped *.bitsocial.localhost route when the launcher is avoiding a Portless name collision. Respect the existing PORTLESS=0 fallback instead of hard-coding alternate ports. For USB Android preview, scripts/start-android-usb.mjs uses adb reverse plus Vite on 127.0.0.1, then am start VIEW to open the default browser when the port is listening (disable with ANDROID_USB_OPEN_BROWSER=0).
  • Keep shell helpers thin. When logic becomes stateful or cross-platform, prefer a JS script run by Node.js.
  • Git and worktree helpers must validate input and default to safe operations.
  • If a helper deletes local branches automatically, document the exact eligibility checks and keep the behavior conservative.