From 671723a0ef3d5124fb7cfeff469799ae93a4dee1 Mon Sep 17 00:00:00 2001 From: Thales Maciel Date: Sun, 29 Mar 2026 17:52:58 -0300 Subject: [PATCH] Add file first guidance for CLI and LLM inputs Capture the repository preference that shell facing tools should consume files when they support them instead of large inline strings. Add explicit guidance for prompt files, temporary files, and git commit message files so future automation avoids quoting bugs and stays aligned with the vm run harness and commit workflows. --- AGENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 60d086d..b67b38f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,6 +35,10 @@ - Prefer small, direct Go code and standard library solutions. - Keep shell scripts strict with `set -euo pipefail`. - Use `gofmt` for Go formatting. +- When a CLI accepts either an inline string or a file input, always prefer the file-based form. +- For shell commands and AI/LLM tooling, prefer passing files as input whenever the CLI allows it. +- Create temporary files as needed to follow the file-first rule. +- Examples: use `git commit -F ` instead of `git commit -m `, and use prompt files instead of inline prompt strings when invoking LLM CLIs. ## Testing Guidance