docs: document Qwen3 thinking-mode quirks and the ReAct workarounds

New subsection 'Handling Qwen3's known quirks' inside the ReAct agent
section explains:
  - Qwen3 ships with thinking mode on by default and emits <think>
    blocks that break strict-format agents.
  - The pipeline applies four defensive patches: /no_think prefix,
    _strip_thinking() post-processing, English system prompt with a
    few-shot example, and TEMPERATURE=0.0 default.
  - Out-of-scope Qwen3 caveats: shaky native tool calling via OVMS
    (which is why we use a text-prompted ReAct loop), and ~32k
    context window.

Both README.md (EN) and README.es.md (ES) updated symmetrically.

Author: cartesiosson

README.es.md

@@ -327,6 +327,32 @@ Open WebUI → Admin Panel → Pipelines → `react-agent` → Valves. Puedes aj
 - `MODEL` (cambiar a otro modelo de OVMS)
 - `SHOW_TRACE` (oculta el trace si quieres sólo la respuesta final)
 
+**Manejando las peculiaridades conocidas de Qwen3**:
+
+Qwen3 viene con **thinking mode activado por defecto** — emite bloques
+`<think>...</think>` con razonamiento libre antes de cualquier salida
+estructurada. Eso rompe la gramática estricta `Thought: / Action: /
+Action Input:` en la que se basa el loop ReAct. Este pipeline aplica
+cuatro parches defensivos:
+
+| Parche | Por qué es necesario |
+|---|---|
+| El system prompt empieza con `/no_think` | Directiva oficial de Qwen3 para saltarse la fase de thinking. Sin esto el modelo divaga en prosa y el parser regex falla en el turno 1. |
+| La salida pasa por `_strip_thinking()` (elimina cualquier bloque `<think>...</think>`) antes de parsear | Defensa por si Qwen3 ignora el `/no_think` en algún turno. Lo limpiamos en vez de fallar. |
+| System prompt en **inglés** con ejemplo few-shot | Qwen3 sigue mejor las instrucciones en inglés; el instruction-tuning está sesgado hacia ese idioma. |
+| `TEMPERATURE` default `0.0` (antes 0.2) | El cumplimiento del formato se vuelve determinista. Súbela vía valves solo si quieres variedad estilística en las respuestas. |
+
+Estos cuatro parches juntos llevan el loop de "falla en el primer turno"
+a "completa en ~4 s una query con `calc`" sobre el mismo hardware.
+
+Otros caveats de Qwen3 que quedan fuera del pipeline pero conviene saber:
+- **Tool calling nativo de OpenAI**: el soporte de `tools=[...]` de
+  Qwen3-8B vía OVMS es flojo. Usamos un loop ReAct por texto en su
+  lugar — más lento, pero mucho más fiable en modelos pequeños.
+- **Ventana de contexto**: ~32k tokens. Traces ReAct largos con muchas
+  llamadas a tools pueden pasarse; baja `MAX_ITERATIONS` o
+  `MAX_TOKENS_PER_STEP` si ves truncado.
+
 **Pipelines vs Tools nativas — cuándo usar qué**:
 - *Tools nativas* (paso 5): el LLM elige cuándo llamarlas vía `tools=[...]` en la API. Más rápido, menos transparente.
 - *ReAct pipeline*: loop explícito en Python, controlas iteraciones y prompt, ves todos los pasos. Más robusto cuando el modelo flojea en function calling nativo.

README.md

@@ -332,6 +332,31 @@ Open WebUI → Admin Panel → Pipelines → `react-agent` → Valves. You can t
 - `MODEL` (point at a different OVMS model)
 - `SHOW_TRACE` (hide the trace if you only want the final answer)
 
+**Handling Qwen3's known quirks**:
+
+Qwen3 ships with **thinking mode enabled by default** — it emits free-form
+`<think>...</think>` blocks before any structured output. That breaks the
+strict `Thought: / Action: / Action Input:` grammar the ReAct loop relies on.
+This pipeline applies three defensive patches:
+
+| Patch | Why it's needed |
+|---|---|
+| System prompt starts with `/no_think` | Qwen3's official directive to skip the thinking phase. Without it the model rambles in prose and the regex parser bails on turn 1. |
+| Output is run through `_strip_thinking()` (removes any `<think>...</think>` blocks) before parsing | Defensive — Qwen3 occasionally still emits a short `<think>` even with `/no_think`. We strip it instead of failing. |
+| System prompt is in **English** with a few-shot example | Qwen3 follows English ReAct system prompts more reliably than Spanish; instruction tuning is heavily weighted toward English. |
+| Default `TEMPERATURE = 0.0` (was 0.2) | Format compliance becomes deterministic. Raise via valves only if you want stylistic variety in answers. |
+
+These four patches together make the loop go from "fails immediately"
+to "completes in ~4 s for a `calc` query" on the same hardware.
+
+Other Qwen3 caveats that are out of scope of this pipeline but worth knowing:
+- **Native OpenAI tool calling**: Qwen3-8B's `tools=[...]` support is shaky
+  via OVMS. We use a text-prompted ReAct loop instead, which is slower but
+  far more reliable on small models.
+- **Context window**: ~32k tokens. Long ReAct traces with many tool calls
+  can blow past it; lower `MAX_ITERATIONS` or `MAX_TOKENS_PER_STEP` if you
+  see truncation.
+
 **Pipelines vs native Tools — when to use which**:
 - *Native tools* (step 5): the LLM decides when to call them via `tools=[...]` in the API. Faster, less transparent.
 - *ReAct pipeline*: explicit loop in Python, you control iterations and prompt, you see every step. More robust when the model is shaky on native function calling.