From 1bf5582c83779c5d7c063775716e6fe1e39aea0e Mon Sep 17 00:00:00 2001
From: Chummy <chumyin0912@gmail.com>
Date: Thu, 19 Feb 2026 18:39:16 +0800
Subject: [PATCH] docs(provider): clarify credential resolution for fallback
 chains

---
 docs/providers-reference.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/providers-reference.md b/docs/providers-reference.md
index ddefb8c..cfa3c36 100644
--- a/docs/providers-reference.md
+++ b/docs/providers-reference.md
@@ -18,6 +18,10 @@ Runtime resolution order is:
 2. Provider-specific env var(s)
 3. Generic fallback env vars: `ZEROCLAW_API_KEY` then `API_KEY`
 
+For resilient fallback chains (`reliability.fallback_providers`), each fallback
+provider resolves credentials independently. The primary provider's explicit
+credential is not reused for fallback providers.
+
 ## Provider Catalog
 
 | Canonical ID | Aliases | Local | Provider-specific env var(s) |