From 33daec69d491ba4b449571024a80f5caf95e1d69 Mon Sep 17 00:00:00 2001
From: ydflow <314143294+ydflow@users.noreply.github.com>
Date: Wed, 30 Sep 2026 22:22:34 +0800
Subject: [PATCH] docs(config): clarify unreadable project scope fallback

---
 docs/designs/data-directory-layout.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/designs/data-directory-layout.md b/docs/designs/data-directory-layout.md
index 01e6cc337..4d8a6053a 100644
--- a/docs/designs/data-directory-layout.md
+++ b/docs/designs/data-directory-layout.md
@@ -272,8 +272,11 @@ partition on the next write command, so the workspace ends up with zero residue.
   `contribute --scope user` (the user install's queue) and `import --from-mr
   --output` (drafts only) do not write this project's queue, so they do not
   migrate either.
-  Read-only commands (`status`, `recall`, …) keep using the double-read fallback
-  and never move data.
+  Read-only commands (`status`, `recall`, …) never move data. They can still read
+  a valid legacy project config through the double-read fallback, but an existing
+  unreadable project config is not treated as absent: scope resolution stops
+  with a config error instead of falling back to another project's or the user
+  scope (#899).
 - `hook-dispatch` is excluded outright (via `TEAMAI_HOOK_SUBCOMMANDS`): it is a
   high-frequency silent path and must never move 12 MB.
 - `--dry-run` (the existing global flag) previews without writing.