Agyloop Quality Gates

---
name: agyloop-quality-gates
description: How to run and fix ruff, mypy --strict, pytest, lint-imports, bandit, pip-audit, mkdocs. Consult when a gate fails.
allowed-tools: Bash(ruff *) Bash(mypy *) Bash(pytest *) Bash(lint-imports) Bash(bandit *) Bash(pip-audit *) Bash(pre-commit *) Bash(mkdocs *) Read
---

# agyloop quality gates

```bash
ruff check src tests
ruff format --check src tests
mypy --strict src/agyloop
pytest
pytest -m system
lint-imports
bandit -q -r src/agyloop
pip-audit
mkdocs build --strict
```

| Gate | Fix |
|---|---|
| `ruff check` | `ruff check --fix src tests` |
| `ruff format` | `ruff format src tests` |
| `mypy` | Annotate. No bare `Any` without a reason. |
| `lint-imports` | Move code to the correct layer (architecture skill). |
| `bandit` | Fix, or `# nosec Bxxx` with *why*. |
| `pip-audit` | Bump the dependency. |
| `mkdocs` | Broken link or missing nav entry. |

`pre-commit run --all-files` runs the hook subset. Python 3.12–3.13 in CI.