docs: expand Key Commands section with comprehensive command reference

- Add missing delete command to documentation
- Include all global flags (--config, --verbose, --version, --help)
- Add practical usage examples for all commands
- Emphasise dependency-aware ordering for both deploy and delete commands
- Provide complete quick reference for users

Author: orien

AGENTS.md

@@ -413,7 +413,6 @@ Must be presented to and approved by the human before committing.
 ### Debug Flags
 - Use `--verbose` flag for detailed output
 - Enable AWS SDK logging with environment variables
-- Use `--dry-run` for safe testing
 
 ### Logging
 - Use structured logging for AWS operations

README.md

@@ -131,5 +131,34 @@ stackaroo diff development app
 
 ### Key Commands
 
-- `deploy <context> [stack]` - Deploy all stacks or a specific stack
-- `diff <context> <stack>` - Preview changes before deployment
+#### Core Commands
+- `deploy <context> [stack-name]` - Deploy all stacks or a specific stack with dependency-aware ordering and integrated change preview
+- `diff <context> <stack-name>` - Preview changes between deployed stack and local configuration
+- `delete <context> [stack-name]` - Delete stacks with dependency-aware ordering and confirmation prompts
+
+#### Global Flags
+- `--config, -c` - Specify config file (default: stackaroo.yaml)
+- `--verbose, -v` - Enable verbose output for detailed logging
+- `--version` - Show version information
+- `--help` - Show help for any command
+
+#### Usage Examples
+```bash
+# Deploy all stacks in development context
+stackaroo deploy development
+
+# Deploy specific stack with verbose output
+stackaroo deploy production app --verbose
+
+# Preview changes before deployment
+stackaroo diff staging vpc
+
+# Delete specific stack with confirmation
+stackaroo delete development app
+
+# Delete all stacks in context (reverse dependency order)
+stackaroo delete development
+
+# Use custom config file
+stackaroo deploy prod --config custom-config.yaml
+```