chore(repo): track agent guidance and ignore local artifacts

.gitignore

@@ -1,8 +1,10 @@
 __pycache__/
 *.pyc
 .venv/
+build/
 dist/
 *.egg-info/
+.omx/
 .pytest_cache/
 .ruff_cache/
 .coverage

AGENTS.md

@@ -0,0 +1,41 @@
+# PortkeyDrop — AI Agent Guidelines
+
+Cross-platform SFTP file transfer tool with screen reader accessibility. Package: `portkeydrop`. Config dir: `~/.portkeydrop`.
+
+## Quick Reference
+
+```bash
+uv run ruff check --fix . && uv run ruff format .   # Lint + format
+uv run pytest                                        # Run tests (132 tests)
+uv run pytest tests/test_file.py::test_func          # Single test
+uv run pytest -n auto                               # Parallel tests
+```
+
+## Branch Strategy
+
+| Branch | Purpose |
+|--------|---------|
+| `main` | Stable releases |
+| `dev` | Active development — PRs go here |
+| `feature/*` | Feature work → PR to dev |
+| `fix/*` | Bug fixes → PR to dev |
+
+## Commit Format
+
+```
+type(scope): description
+Types: feat, fix, docs, style, refactor, test, chore
+```
+
+## PR Rules
+
+- Always PR to `dev`, never `main`
+- Title in Conventional Commit format
+- Body via `--body-file` (never inline `--body`)
+- Do not auto-merge
+
+## Key Notes
+
+- Three-tier password storage: keyring > encrypted vault > none
+- Accessibility: all interactive UI elements need aria labels
+- SFTP operations use `asyncssh`