diff --git a/AGENTS.md b/AGENTS.md
index 3a7397c22..56b15da7f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -27,10 +27,10 @@ on these are available in the `JOURNAL.md` file.
 
 ## Development guidelines
 
-- Use **Python 3.9+** and keep code formatted with `black` (line length 100) and
+- Use **Python 3.9+** and keep code formatted with `black` and
   `isort`. The configuration resides in `pyproject.toml`.
 - Linting with `flake8` and type checking with `mypy` are recommended.
-- If tests are added under `tests/`, run `pytest` before committing.
+- Tests are under `tests/`, run `pytest` before committing, install dependencies or use mocks if needed.
 - The dependencies declared in `pyproject.toml` include heavy optional
   packages (for example `torch` and `PyGObject`).  If `pip install -e .[dev]`
   fails you can install only the minimal set needed for the tests:
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 000000000..47dc3e3d8
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file