janjaszczak cross-platform-safety
Activation gate (anti-noise)
Activate if any of:
- The user mentions Windows/WSL/PowerShell/Docker explicitly.
- You must provide shell commands that could differ by OS.
- Paths/permissions/volumes/networking are involved.
Procedure
- Determine execution context:
- Where the command will run (Windows host? WSL? container?).
- Provide OS-specific variants ONLY if needed:
- Prefer a single canonical path + “Windows note” if small delta.
- Guardrails:
- Avoid reserved PowerShell variables and quoting pitfalls.
- Avoid whitespace path breakage; use explicit quoting.
- Validate critical commands with “dry read” steps (e.g.,
pwd,whoami,ls).
Output
- “Run in: ” + exact command(s) + 1–2 quick verification commands.