AGENTS.md still referenced color-eyre after the miette switch.

Assisted-by: Claude Opus 4.6 via pi

diff --git a/AGENTS.md b/AGENTS.md
index f30ddba..f906164 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,7 +33,7 @@ just           # All four
 ## Conventions
 
 - Rust edition 2024, resolver v2 workspace.
-- Error handling uses `color-eyre`. Prefer `wrap_err` / `bail!` over `.unwrap()`.
+- Error handling uses `miette`. Prefer `wrap_err` / `bail!` over `.unwrap()`. Use `.into_diagnostic()` to convert standard errors before `?` or `.wrap_err()`.
 - File I/O uses `fs-err` instead of `std::fs`. The clippy config enforces this.
 - Logging uses `tracing` with `tracing-subscriber` and `EnvFilter`. Use `tracing::info`, `tracing::error`, etc. — not `println!` or `eprintln!`.
 - All CI checks must pass: `cargo fmt --all --check`, `cargo clippy --workspace -- -D warnings`, `cargo test --workspace`.
diff --git a/README.md b/README.md
index 0f8a350..67f1dd4 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,13 @@ A Rust CLI orchestrates a Docker Compose stack. On each run it:
 
 `config` prints resolved paths, volume mounts, and Dockerfile status without starting anything — useful for debugging mount issues.
 
+`completions <shell>` generates shell completions for bash, zsh, fish, elvish, or powershell. Pipe the output to a file sourced by your shell:
+
+```sh
+ramekin completions zsh > ~/.zfunc/_ramekin
+ramekin completions bash > ~/.local/share/bash-completion/completions/ramekin
+```
+
 ### Persistence
 
 The agent directory (`$XDG_CONFIG_HOME/ramekin/agent/`) is mounted into the container at `/root/.pi/agent`. It holds: