chore: update CI configuration and improve README instructions

.github/workflows/ci.yml

@@ -107,7 +107,6 @@ jobs:
           CLERK_SECRET_KEY: ${{ secrets.CLERK_SECRET_KEY }}
         run: |
           make backend-lint
-          make backend-typecheck
           make backend-coverage
 
       - name: Run frontend checks
@@ -125,7 +124,7 @@ jobs:
           make frontend-build
 
 
-      - name: Docs quality gates (lint + relative link check)
+      - name: Docs quality gates
         run: |
           make docs-check
 

Makefile

@@ -55,10 +55,10 @@ frontend-format-check: frontend-tooling ## Check frontend formatting (prettier)
 	$(NODE_WRAP) --cwd $(FRONTEND_DIR) npx prettier --check "src/**/*.{ts,tsx,js,jsx,json,css,md}" "*.{ts,js,json,md,mdx}"
 
 .PHONY: lint
-lint: backend-lint frontend-lint ## Lint backend + frontend
+lint: backend-lint frontend-lint docs-lint ## Lint backend + frontend + docs
 
 .PHONY: backend-lint
-backend-lint: ## Lint backend (flake8)
+backend-lint: backend-format-check backend-typecheck ## Lint backend (isort/black checks + flake8 + mypy)
 	cd $(BACKEND_DIR) && uv run flake8 --config .flake8
 
 .PHONY: frontend-lint

backend/README.md

@@ -101,17 +101,20 @@ Notes:
 From repo root (recommended):
 
 ```bash
-make backend-test
 make backend-lint
-make backend-typecheck
+make backend-test
 make backend-coverage
 ```
 
+`make backend-lint` runs backend format checks (`isort`, `black`), lint (`flake8`), and typecheck (`mypy`) in one command.
+
 Or from `backend/`:
 
 ```bash
 cd backend
 uv run pytest
+uv run isort . --check-only --diff
+uv run black . --check --diff
 uv run flake8 --config .flake8
 uv run mypy
 ```

docs/troubleshooting/gateway-agent-provisioning.md

@@ -104,4 +104,3 @@ Actions:
    - gateway logs around bootstrap
    - worker logs around lifecycle events
    - agent `last_provision_error`, `wake_attempts`, `last_seen_at`
-