docs: add LLM model defaults (Nov 2025) to agent guidance files

AGENTS.md

@@ -89,6 +89,21 @@ DeepBonerError (base)
 └── ConfigurationError
 ```
 
+## LLM Model Defaults (November 2025)
+
+Given the rapid advancements, as of November 29, 2025, the DeepBoner project uses the following default LLM models in its configuration (`src/utils/config.py`):
+
+- **OpenAI:** `gpt-5`
+  - This is the stable flagship model released in August 2025.
+  - While `gpt-5.1` (released November 2025) exists, it is currently gated, and attempts to use it resulted in a `403 model_not_found` error for typical API keys. Advanced users with access to `gpt-5.1-instant`, `gpt-5.1-thinking`, or `gpt-5.1-codex-max` may configure their `.env` accordingly.
+- **Anthropic:** `claude-sonnet-4-5-20250929`
+  - This is the mid-range Claude 4.5 model, released on September 29, 2025.
+  - The flagship `Claude Opus 4.5` (released November 24, 2025) is also available and can be configured by advanced users for enhanced capabilities.
+- **HuggingFace (Free Tier):** `meta-llama/Llama-3.1-70B-Instruct`
+  - This remains the default for the free tier, subject to quota limits.
+
+It is crucial to keep these defaults updated as the LLM landscape evolves.
+
 ## Testing
 
 - **TDD**: Write tests first in `tests/unit/`, implement in `src/`

CLAUDE.md

@@ -96,6 +96,21 @@ DeepBonerError (base)
 - **Mocking**: `respx` for httpx, `pytest-mock` for general mocking
 - **Fixtures**: `tests/conftest.py` has `mock_httpx_client`, `mock_llm_response`
 
+## LLM Model Defaults (November 2025)
+
+Given the rapid advancements, as of November 29, 2025, the DeepBoner project uses the following default LLM models in its configuration (`src/utils/config.py`):
+
+- **OpenAI:** `gpt-5`
+  - This is the stable flagship model released in August 2025.
+  - While `gpt-5.1` (released November 2025) exists, it is currently gated, and attempts to use it resulted in a `403 model_not_found` error for typical API keys. Advanced users with access to `gpt-5.1-instant`, `gpt-5.1-thinking`, or `gpt-5.1-codex-max` may configure their `.env` accordingly.
+- **Anthropic:** `claude-sonnet-4-5-20250929`
+  - This is the mid-range Claude 4.5 model, released on September 29, 2025.
+  - The flagship `Claude Opus 4.5` (released November 24, 2025) is also available and can be configured by advanced users for enhanced capabilities.
+- **HuggingFace (Free Tier):** `meta-llama/Llama-3.1-70B-Instruct`
+  - This remains the default for the free tier, subject to quota limits.
+
+It is crucial to keep these defaults updated as the LLM landscape evolves.
+
 ## Git Workflow
 
 - `main`: Production-ready (GitHub)

GEMINI.md

@@ -70,6 +70,21 @@ Settings via pydantic-settings from `.env`:
 - `MAX_ITERATIONS`: 1-50, default 10
 - `LOG_LEVEL`: DEBUG, INFO, WARNING, ERROR
 
+## LLM Model Defaults (November 2025)
+
+Given the rapid advancements, as of November 29, 2025, the DeepBoner project uses the following default LLM models in its configuration (`src/utils/config.py`):
+
+- **OpenAI:** `gpt-5`
+  - This is the stable flagship model released in August 2025.
+  - While `gpt-5.1` (released November 2025) exists, it is currently gated, and attempts to use it resulted in a `403 model_not_found` error for typical API keys. Advanced users with access to `gpt-5.1-instant`, `gpt-5.1-thinking`, or `gpt-5.1-codex-max` may configure their `.env` accordingly.
+- **Anthropic:** `claude-sonnet-4-5-20250929`
+  - This is the mid-range Claude 4.5 model, released on September 29, 2025.
+  - The flagship `Claude Opus 4.5` (released November 24, 2025) is also available and can be configured by advanced users for enhanced capabilities.
+- **HuggingFace (Free Tier):** `meta-llama/Llama-3.1-70B-Instruct`
+  - This remains the default for the free tier, subject to quota limits.
+
+It is crucial to keep these defaults updated as the LLM landscape evolves.
+
 ## Development Conventions
 
 1. **Strict TDD:** Write failing tests in `tests/unit/` *before* implementing logic in `src/`.