Behavioral contracts

These documents define detailed product behavior and implementation boundaries beyond the task-oriented command pages.

• PowerShell and Bash behavioral parity — shared observable behavior and intentional runtime differences
• Native-command failure boundaries — external-command results that are correctness-significant
• PowerShell removal contract — PowerShell ShouldProcess, -WhatIf, -Confirm, and removal confirmation semantics

For normal user tasks, start with Commands. Platform-specific syntax belongs in the getting-started guides.