liitkud · kuyacarlo · Jul 24, 2026 · Jul 24, 2026 · Jul 24, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,4 +1,17 @@
-<!-- SPECKIT START -->
-For additional context about technologies to be used, project structure,
-shell commands, and other important information, read the current plan
-<!-- SPECKIT END -->
+# Agent notes — ComplyAIgent
+
+## Read first
+- [docs/ROADMAP.md](docs/ROADMAP.md) — phases and non-goals
+- [docs/mvp/README.md](docs/mvp/README.md) — MVP definition of done + workstreams
+- [docs/handover/README.md](docs/handover/README.md) — architecture + current priorities
+- [docs/ONBOARDING.md](docs/ONBOARDING.md) — local setup
+- Epic: https://github.com/liitkud/complyaigent/issues/74
+
+## Defaults
+- Branch from `dev`; small PRs mapped to MVP sub-issues (#75–#81)
+- Backend: `cd backend && uv sync && uv run …`
+- Do not reintroduce floating unpinned `ruff`/`ty` in CI without lockfile pins
+- Prefer project-scoped changes; no drive-by refactors outside the issue
+
+## Speckit
+Feature plans live under `specs/` and `.specify/`. Constitution: `docs/constitution.md` → `.specify/memory/constitution.md`.
diff --git a/backend/.gitignore b/backend/.gitignore
diff --git a/backend/.python-version b/backend/.python-version
diff --git a/backend/.secrets.baseline b/backend/.secrets.baseline
diff --git a/backend/Dockerfile b/backend/Dockerfile
diff --git a/backend/app/__init__.py b/backend/app/__init__.py
diff --git a/backend/app/api/activity.py b/backend/app/api/activity.py
diff --git a/backend/app/api/ingest.py b/backend/app/api/ingest.py
diff --git a/backend/app/api/manifest.py b/backend/app/api/manifest.py
diff --git a/backend/app/api/validate.py b/backend/app/api/validate.py
diff --git a/backend/app/core/config.py b/backend/app/core/config.py
diff --git a/backend/app/core/db.py b/backend/app/core/db.py
diff --git a/backend/app/core/hashing.py b/backend/app/core/hashing.py
diff --git a/backend/app/core/logging.py b/backend/app/core/logging.py
diff --git a/backend/app/core/rate_limit.py b/backend/app/core/rate_limit.py
diff --git a/backend/app/models/rule.py b/backend/app/models/rule.py
diff --git a/backend/app/models/task.py b/backend/app/models/task.py
diff --git a/backend/app/regintel/__init__.py b/backend/app/regintel/__init__.py
diff --git a/backend/app/regintel/rag.py b/backend/app/regintel/rag.py
diff --git a/backend/app/services/categorizer.py b/backend/app/services/categorizer.py
diff --git a/backend/app/services/compactor.py b/backend/app/services/compactor.py
diff --git a/backend/app/services/comparator.py b/backend/app/services/comparator.py
diff --git a/backend/app/services/extractor.py b/backend/app/services/extractor.py
diff --git a/backend/app/services/logger.py b/backend/app/services/logger.py
diff --git a/backend/app/services/pipeline.py b/backend/app/services/pipeline.py
diff --git a/backend/app/services/validator.py b/backend/app/services/validator.py
diff --git a/backend/app/worker/tasks.py b/backend/app/worker/tasks.py
diff --git a/backend/main.py b/backend/main.py
diff --git a/backend/pyproject.toml b/backend/pyproject.toml
@@ -56,7 +56,7 @@ select = [
 ]
 ignore = [
     "B008",   # Do not perform function call `Depends` in parameter defaults
-    "EXE002", # The file is executable but no shebang is present
+    # The file is executable but no shebang is present
     "E501",   # Line too long
     "BLE001", # Do not catch blind exception: Exception
 ]

diff --git a/backend/requirements.txt b/backend/requirements.txt
diff --git a/backend/tests/conftest.py b/backend/tests/conftest.py
diff --git a/backend/tests/integration/test_ingestion.py b/backend/tests/integration/test_ingestion.py
diff --git a/backend/tests/integration/test_observability.py b/backend/tests/integration/test_observability.py
diff --git a/backend/tests/integration/test_validation.py b/backend/tests/integration/test_validation.py
diff --git a/backend/uv.lock b/backend/uv.lock