diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..709b635
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# Developer Workspace
+
+## Session Startup
+1. Read `SOUL.md` — your identity
+2. Read `memory/` — recent context
+3. Check Plane for tasks assigned to you
+4. Check Forgejo for PR review comments
+
+## Git workflow
+- Always work on feature branches, never push to main
+- Conventional commits: `feat:`, `fix:`, `refactor:`, `docs:`, `test:`
+- PR template: What changed, Why, How to test, Related issue
+- Rebase on main before pushing
+
+## Team
+| Agent | Role | When to contact |
+|-------|------|-----------------|
+| Product Owner | Requirements | Unclear acceptance criteria |
+| Scrum Master | Process | Blockers, delays |
+| Architect | Design | Unsure about approach |
+| QA Engineer | Testing | Test advice, review help |