docs: guide LLM-specific tweaks through model features

[enyst]

Summary

• Add repository guidance that LLM-specific behavior changes should start in model_features.py when they can be represented as model/provider capabilities.
• Explicitly discourage provider-specific criteria in llm.py unless the behavior cannot be expressed cleanly in the feature registry or a focused helper.

Validation

• uv run pre-commit run --files AGENTS.md

This PR was created by an AI agent (OpenHands) on behalf of the user.

@enyst can click here to continue refining the PR

---

Agent Server images for this PR

• GHCR package: https://github.com/OpenHands/agent-sdk/pkgs/container/agent-server

Variants & Base Images

Variant	Architectures	Base Image	Docs / Tags
java	amd64, arm64	eclipse-temurin:17-jdk	Link
python	amd64, arm64	nikolaik/python-nodejs:python3.13-nodejs22-slim	Link
golang	amd64, arm64	golang:1.21-bookworm	Link

Pull (multi-arch manifest)

# Each variant is a multi-arch manifest supporting both amd64 and arm64
docker pull ghcr.io/openhands/agent-server:09669a1-python

Run

docker run -it --rm \
  -p 8000:8000 \
  --name agent-server-09669a1-python \
  ghcr.io/openhands/agent-server:09669a1-python

All tags pushed for this build

ghcr.io/openhands/agent-server:09669a1-golang-amd64
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-golang-amd64
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-golang-amd64
ghcr.io/openhands/agent-server:09669a1-golang_tag_1.21-bookworm-amd64
ghcr.io/openhands/agent-server:09669a1-golang-arm64
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-golang-arm64
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-golang-arm64
ghcr.io/openhands/agent-server:09669a1-golang_tag_1.21-bookworm-arm64
ghcr.io/openhands/agent-server:09669a1-java-amd64
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-java-amd64
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-java-amd64
ghcr.io/openhands/agent-server:09669a1-eclipse-temurin_tag_17-jdk-amd64
ghcr.io/openhands/agent-server:09669a1-java-arm64
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-java-arm64
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-java-arm64
ghcr.io/openhands/agent-server:09669a1-eclipse-temurin_tag_17-jdk-arm64
ghcr.io/openhands/agent-server:09669a1-python-amd64
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-python-amd64
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-python-amd64
ghcr.io/openhands/agent-server:09669a1-nikolaik_s_python-nodejs_tag_python3.13-nodejs22-slim-amd64
ghcr.io/openhands/agent-server:09669a1-python-arm64
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-python-arm64
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-python-arm64
ghcr.io/openhands/agent-server:09669a1-nikolaik_s_python-nodejs_tag_python3.13-nodejs22-slim-arm64
ghcr.io/openhands/agent-server:09669a1-golang
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-golang
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-golang
ghcr.io/openhands/agent-server:09669a1-golang_tag_1.21-bookworm
ghcr.io/openhands/agent-server:09669a1-java
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-java
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-java
ghcr.io/openhands/agent-server:09669a1-eclipse-temurin_tag_17-jdk
ghcr.io/openhands/agent-server:09669a1-python
ghcr.io/openhands/agent-server:09669a16a6ba7ab39d98733f07bf4301419ba40d-python
ghcr.io/openhands/agent-server:openhands-llm-feature-guidance-python
ghcr.io/openhands/agent-server:09669a1-nikolaik_s_python-nodejs_tag_python3.13-nodejs22-slim

About Multi-Architecture Support

• Each variant tag (e.g., 09669a1-python) is a multi-arch manifest supporting both amd64 and arm64
• Docker automatically pulls the correct architecture for your platform
• Individual architecture tags (e.g., 09669a1-python-amd64) are also available if needed

[github-actions]

Python API breakage checks — ✅ PASSED

Result: ✅ PASSED

Action log

[github-actions]

REST API breakage checks (OpenAPI) — ✅ PASSED

Result: ✅ PASSED

Action log