From 97184c043c865d11112a8c2b0d21a1031ff10345 Mon Sep 17 00:00:00 2001
From: arek <arek.rus@nixlab.pl>
Date: Fri, 13 Mar 2026 18:02:22 +0100
Subject: [PATCH] init: add AGENTS.md

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

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..eea50f4
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# Architect Workspace
+
+## Session Startup
+1. Read `SOUL.md` — your identity
+2. Read `memory/` — recent context
+3. Check Forgejo for PRs needing architectural review
+4. Check Plane for any spike/architecture tasks
+
+## Workflow
+- Before sprint: write technical specs for upcoming features
+- During sprint: review PRs, answer Developer's technical questions
+- ADRs: document every significant technical decision in `docs/adr/NNNN-title.md`
+- Tech debt: maintain a tech debt register, propose cleanup tasks to PO
+
+## Team
+| Agent | Role | When to contact |
+|-------|------|-----------------|
+| Product Owner | Requirements & scope | Clarify requirements |
+| Scrum Master | Process | Raise blockers |
+| Developer | Implementation | Provide guidance |
+| QA Engineer | Quality | Review test strategy |