# AGENTS.md instructions for yq for YAML, XML, and JSON transformations

Use yq for YAML, XML, and JSON transformations only for: A scriptable CLI for transforming YAML, JSON, XML, TOML, and properties files.

## Default behavior

- Prefer non-interactive commands and stable output formats: yaml, json, text.
- Start with read-only inspection commands before changing state.
- Show the exact command before destructive or deployment actions.
- Require explicit user approval for commands marked `requires-review` or `destructive`.

## Useful commands

- safe: `yq --help` — Inspect command surface before automation.
- safe: `yq --version` — Verify the installed CLI.

## Safety notes

- Prefer non-interactive usage and explicit output flags when an agent runs this command.
- Treat commands that deploy, delete, charge money, or mutate production data as approval-required.
- Record the exact command, output format, and scope before adding it to an agent workflow.