From 882fe4aa3c4852169ed72e14915ac11c23eed40f Mon Sep 17 00:00:00 2001
From: Hermes <hermes@lazyworkhorse.net>
Date: Tue, 19 May 2026 15:27:53 -0400
Subject: [PATCH] docs: add AGENTS.md with dev workflow conventions

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

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..60e1c85
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,12 @@
+# AGENTS.md
+
+Personal development conventions — applies to all projects unless overridden by a project-level AGENTS.md.
+
+## Workflow
+
+- New feature → clean branch from `origin/master` → push → PR on Gitea
+- Branch naming: `feat/description` (features), `fix/description` (bugs/docs/docs/chores)
+- Always branch from `origin/master`, never from another feature branch
+- PR title describes the change; body explains motivation + summary
+- After PR merge, delete the feature branch
+- Always validate before push (build, lint, test)