From d2dd96e0e6870d814bebb0854bd146394cb490d7 Mon Sep 17 00:00:00 2001
From: Owais Jamil <desertthunder.dev@gmail.com>
Date: Thu, 1 Jan 2026 18:36:11 -0600
Subject: [PATCH] docs: update agent guidelines with .sandbox usage

---
 .gitignore |  2 ++
 AGENTS.md  | 14 +++++++++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 59a2a12..200de53 100644
--- a/.gitignore
+++ b/.gitignore
@@ -20,3 +20,5 @@ target
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
 .env
+
+.sandbox
diff --git a/AGENTS.md b/AGENTS.md
index e7100cc..744e7ca 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -69,4 +69,16 @@ pnpm lint
 
 ## Rules & Workflows
 
-- *todo*
+In general, before working on features locally, specs should have already been drafted
+by the developer.
+
+### Specs
+
+When drafting specs, let's use the `.sandbox` directory and format filenames with the
+following format:
+
+```sh
+.sandbox/spec_<feature>-<description>_YYYY-MM-DD.md
+```
+
+Each section should have an overview and `- [ ]` items for tasks.
-- 
2.51.2