From c640cfefe8ce8503056e5e4a5c8c6fc67d9b38eb Mon Sep 17 00:00:00 2001
From: catlog22 <catlog22@github.com>
Date: Tue, 21 Oct 2025 15:58:02 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=99=BA=E8=83=BD?=
 =?UTF-8?q?=E5=B7=A5=E5=85=B7=E9=80=89=E6=8B=A9=E7=AD=96=E7=95=A5=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3=EF=BC=8C=E6=98=8E=E7=A1=AE=E5=A4=96=E9=83=A8=E7=9B=AE?=
 =?UTF-8?q?=E5=BD=95=E5=BC=95=E7=94=A8=E7=9A=84=E4=B8=A4=E6=AD=A5=E8=A6=81?=
 =?UTF-8?q?=E6=B1=82=E5=92=8C=E7=A4=BA=E4=BE=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .claude/commands/cli/chat.md                  | 10 ++++++----
 .../workflows/intelligent-tools-strategy.md   | 20 +++++++++++--------
 2 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/.claude/commands/cli/chat.md b/.claude/commands/cli/chat.md
index 7328c98d..f797dbf2 100644
--- a/.claude/commands/cli/chat.md
+++ b/.claude/commands/cli/chat.md
@@ -67,7 +67,7 @@ The agent handles all phases internally.
 
 ## Context Assembly
 
-**Always included**: `@CLAUDE.md @**/*CLAUDE.md` (project guidelines)
+**Always included**: `@CLAUDE.md @**/*CLAUDE.md` (project guidelines, space-separated)
 
 **Optional**:
 - User-explicit files from inquiry keywords
@@ -79,10 +79,12 @@ For targeted analysis, use `rg` or MCP tools to discover relevant files first, t
 
 ```bash
 cd . && gemini -p "
-INQUIRY: [user question]
-CONTEXT: @CLAUDE.md,**/*CLAUDE.md [inferred files or @**/* for all files]
+PURPOSE: Answer user inquiry about codebase
+TASK: [user question]
 MODE: analysis
-RESPONSE: Direct answer, explanation, insights (NO code modification)
+CONTEXT: @CLAUDE.md @**/*CLAUDE.md [inferred files or @**/* for all files]
+EXPECTED: Direct answer, explanation, insights (NO code modification)
+RULES: Focus on clarity and accuracy
 "
 ```
 
diff --git a/.claude/workflows/intelligent-tools-strategy.md b/.claude/workflows/intelligent-tools-strategy.md
index 05a5b58a..4b99344f 100644
--- a/.claude/workflows/intelligent-tools-strategy.md
+++ b/.claude/workflows/intelligent-tools-strategy.md
@@ -223,11 +223,13 @@ RULES: [template reference and constraints]
 - `@src/**/*` = Files within src subdirectory (if exists under current directory)
 - **CANNOT reference parent or sibling directories via @ alone**
 
-**To reference files outside current directory**:
-- **MUST use `--include-directories`** to explicitly add external directories
-- Example: `cd src/auth && gemini -p "..." --include-directories ../shared,../config`
-- After adding, @ patterns can then match files in included directories
-- Without `--include-directories`, parent/sibling files are INVISIBLE to @ patterns
+**To reference files outside current directory (TWO-STEP REQUIREMENT)**:
+- **Step 1**: Add `--include-directories` parameter to make external directories ACCESSIBLE
+- **Step 2**: Explicitly reference external files in CONTEXT field with @ patterns
+- **⚠️ BOTH steps are MANDATORY** - missing either step will fail
+- Example: `cd src/auth && gemini -p "CONTEXT: @**/* @../shared/**/*" --include-directories ../shared`
+- **Rule**: If CONTEXT contains `@../dir/**/*`, command MUST include `--include-directories ../dir`
+- Without `--include-directories`, @ patterns CANNOT access parent/sibling directories at all
 
 #### Multi-Directory Support (Gemini & Qwen)
 
@@ -254,7 +256,7 @@ cd src/auth && gemini -p "
 PURPOSE: Analyze authentication with shared utilities context
 TASK: Review auth implementation and its dependencies
 MODE: analysis
-CONTEXT: @**/* (includes current dir + shared + types directories)
+CONTEXT: @**/* @../shared/**/* @../types/**/*
 EXPECTED: Complete analysis with cross-directory dependencies
 RULES: Focus on integration patterns
 " --include-directories ../shared,../types
@@ -262,11 +264,13 @@ RULES: Focus on integration patterns
 
 **Best Practices**:
 - **Recommended Pattern**: Use `cd` to navigate to primary focus directory, then use `--include-directories` for additional context
-  - Example: `cd src/auth && gemini -p "..." --include-directories ../shared,../types`
+  - Example: `cd src/auth && gemini -p "CONTEXT: @**/* @../shared/**/*" --include-directories ../shared,../types`
+  - **⚠️ CRITICAL**: CONTEXT must explicitly list external files (e.g., `@../shared/**/*`), AND command must include `--include-directories ../shared`
   - Benefits: More precise file references (relative to current directory), clearer intent, better context control
+- **Enforcement Rule**: When CONTEXT references external directories, ALWAYS add corresponding `--include-directories`
 - Use when `cd` alone limits necessary context visibility
 - Keep directory count ≤ 5 for optimal performance
-- Combine with specific file patterns in CONTEXT for precision
+- **Pattern matching rule**: `@../dir/**/*` in CONTEXT → `--include-directories ../dir` in command (MANDATORY)
 - Prefer `cd + --include-directories` over multiple `cd` commands for cross-directory analysis
 
 ---