docs: document orphan-YAML gate + --allow-new-files in README and AGENTS#31

dhruva-reddy merged 1 commit into

mainVapiAI/gitops:mainfrom

docs/new-file-gate-docsVapiAI/gitops:docs/new-file-gate-docsCopy head branch name to clipboard