From dd1897d91605dceed7c955985477eac60fe91c08 Mon Sep 17 00:00:00 2001
From: eding <edin.grech@gmail.com>
Date: Mon, 14 Sep 2026 23:07:25 +0200
Subject: [PATCH] docs: require PR handoff

---
 AGENTS.md | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..3c39c74
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,10 @@
+# MaidnCLI Delivery Procedure
+
+## Handoff
+
+- Do not leave completed changes only in a local worktree or branch.
+- Run `git diff --check` and the applicable Go checks before handoff.
+- Push each safe, scoped change on its own branch.
+- Open a Forgejo pull request for every completed branch unless the user explicitly authorizes a direct merge.
+- Return the PR URL. If Forgejo API access prevents PR creation, return the compare URL and state the exact API failure.
+- Never commit generated workspaces, `.password`, SOPS material, kubeconfigs, Terraform state, or recovery material.