diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..2b8555f
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,61 @@
+# AGENTS.md - Django Tienda Project
+
+## Commands
+
+```bash
+# Run tests (runs tienda/tests.py by default)
+make test
+
+# Or manually
+python manage.py test
+
+# Run dev server
+python manage.py runserver
+
+# Run migrations
+python manage.py migrate
+
+# Static files (production)
+python manage.py collectstatic
+```
+
+## Prerequisites
+
+- **Redis**: Must be running on `redis://127.0.0.1:6379/1` for sessions and caching
+  - Start: `sudo systemctl start redis-server` (Linux) or `brew services start redis` (macOS)
+  - Verify: `redis-cli ping` → PONG
+- **PostgreSQL**: Default database; set `POSTGRES_ENABLED=False` to use SQLite
+- **Environment**: Copy `.env.example` to `.env` and configure required vars
+
+## Important Quirks
+
+1. **Migrations**: If `makemigrations` fails with error code 130, **check `tienda/migrations/`** - the file is often created despite the error
+2. **Test DB**: Uses SQLite regardless of POSTGRES_ENABLED (hardcoded in settings.py)
+3. **App URL**: Not at `/` - access at `http://localhost:8000/tienda/`
+4. **Admin**: At `/admin/` (not `/tienda/admin/`)
+5. **Custom User Model**: AUTH_USER_MODEL = 'tienda.User' - use for all user-related queries
+
+## Architecture
+
+- `proyecto/` - Django settings, URLs, WSGI/ASGI
+- `tienda/` - Main app (models, views, admin, templates)
+- `tienda/static/` - CSS, JS, images, fonts
+- Templates extend `tienda/templates/tienda/base.html`
+
+## Shipping Restrictions
+
+Only sells to Almería province, Spain (postal codes 04xxx). All addresses saved with country "España".
+
+## External Services
+
+- **Payment**: Stripe + PayPal (configured via .env)
+- **Storage**: S3 support - set `S3_ENABLE=True` to enable
+- **Email**: SMTP required (see .env.example)
+- **Async**: Celery uses Redis broker
+
+## Useful References
+
+- Full developer docs: `.github/copilot-instructions.md`
+- Redis setup: `docs/REDIS_SETUP.md`
+- PayPal: `docs/PAYPAL_SETUP.md`, `docs/PAYPAL_TROUBLESHOOTING.md`
+- View documentation: `docs/views/`
\ No newline at end of file
diff --git a/PAYPAL_SETUP.md b/docs/PAYPAL_SETUP.md
similarity index 100%
rename from PAYPAL_SETUP.md
rename to docs/PAYPAL_SETUP.md
diff --git a/PAYPAL_TROUBLESHOOTING.md b/docs/PAYPAL_TROUBLESHOOTING.md
similarity index 100%
rename from PAYPAL_TROUBLESHOOTING.md
rename to docs/PAYPAL_TROUBLESHOOTING.md
diff --git a/REDIS_SETUP.md b/docs/REDIS_SETUP.md
similarity index 100%
rename from REDIS_SETUP.md
rename to docs/REDIS_SETUP.md