Working with AI Coding Agents#

Section Author
Ralf Mueller

Optional workflows for AI coding agents live in .agents/. They are not loaded automatically: point your agent at a file when the task fits it.

  • .agents/tool-glab.md: GitLab access via glab without exposing tokens to the agent

  • .agents/tool-gitlab-ci-local.md: run or lint GitLab CI changes locally before pushing

  • .agents/tool-python-venv.md: run Python helper scripts from a project-local .venv

  • .agents/levante-swift.md: read or publish data on the DKRZ Swift object store from Levante

  • .agents/levante-scratch.md: where to put ICON model output on Levante

  • .agents/git-two-branches.md: clean branch for merging plus a -dev branch, in which the agent may commit

  • .agents/practice-measure-first.md: debugging discipline: measure instead of guessing

  • externals/jsbach/AGENTS.md: ICON-Land specifics, when working in externals/jsbach

  • externals/kokkos/.github/copilot-instructions.md: Kokkos specifics, when changing Kokkos itself