@dtt_siye/atool 1.3.1 → 1.5.0

package/bin/atool.js

@@ -61,6 +61,14 @@ function findBashOnWindows() {
 function runInstallSh(args) {
   const argList = Array.isArray(args) ? args : [args];
 
+  // Prepare environment variables
+  const env = { ...process.env, ATOOL_ROOT: ROOT_DIR };
+
+  // Include ATOOL_STACK if set
+  if (env.ATOOL_STACK) {
+    env.ATOOL_STACK = env.ATOOL_STACK;
+  }
+
   if (isWindows()) {
     const bash = findBashOnWindows();
     if (!bash) {
@@ -74,14 +82,14 @@ function runInstallSh(args) {
     execFileSync(bash, [INSTALL_SH, ...argList], {
       stdio: 'inherit',
       cwd: ROOT_DIR,
-      env: { ...process.env, ATOOL_ROOT: ROOT_DIR },
+      env: env,
     });
   } else {
     // macOS / Linux — delegate directly to bash
     execFileSync('bash', [INSTALL_SH, ...argList], {
       stdio: 'inherit',
       cwd: ROOT_DIR,
-      env: { ...process.env, ATOOL_ROOT: ROOT_DIR },
+      env: env,
     });
   }
 }
@@ -145,6 +153,38 @@ function cmdInstall(flags) {
   runInstallSh(installArgs);
 }
 
+function cmdInit(flags) {
+  const initArgs = ['--project'];
+
+  // Extract path argument (only if it's not the value after --stack)
+  let pathArg = null;
+  let stackValue = null;
+
+  // Find --stack and its value first
+  const stackIndex = flags.indexOf('--stack');
+  if (stackIndex !== -1 && stackIndex + 1 < flags.length && !flags[stackIndex + 1].startsWith('--')) {
+    stackValue = flags[stackIndex + 1];
+    // Remove --stack and its value from consideration for pathArg
+    const filteredFlags = flags.filter((flag, index) =>
+      index !== stackIndex && index !== stackIndex + 1
+    );
+    pathArg = filteredFlags.find(flag => !flag.startsWith('--'));
+  } else {
+    pathArg = flags.find(flag => !flag.startsWith('--'));
+  }
+
+  if (pathArg) {
+    initArgs.push(pathArg);
+  }
+
+  // Handle --stack flag
+  if (stackValue) {
+    process.env.ATOOL_STACK = stackValue;
+  }
+
+  runInstallSh(initArgs);
+}
+
 function cmdUpdate(flags) {
   const updateArgs = ['--update'];
   if (hasFlag(flags, 'yes') || hasFlag(flags, 'y')) {
@@ -175,20 +215,22 @@ function cmdHelp() {
   console.log(`aTool - AI Developer Toolkit v${version}`);
   console.log('');
   console.log('Usage:');
-  console.log('  atool install [--all] [--yes] [--claude] [--cursor] [--kiro]');
-  console.log('  atool update [--yes]');
-  console.log('  atool check-updates');
-  console.log('  atool version');
-  console.log('  atool help');
+  console.log('  atool [command] [options]');
   console.log('');
   console.log('Commands:');
   console.log('  install         Install aTool to detected AI IDEs (default: --all)');
+  console.log('  init [PATH]     Initialize a project in current or specified directory');
   console.log('  update          Update aTool to the latest version');
   console.log('  check-updates   Check installed version info (JSON output)');
   console.log('  version         Show current version');
   console.log('  help            Show this help message');
   console.log('');
-  console.log('Options:');
+  console.log('Project Initialization:');
+  console.log('  atool init                    Initialize project in current directory');
+  console.log('  atool init ./my-app           Initialize project in specified directory');
+  console.log('  atool init --stack react      Initialize with specific tech stack');
+  console.log('');
+  console.log('Installation Options:');
   console.log('  --all           Install to all detected IDEs');
   console.log('  --claude        Install to Claude Code CLI only');
   console.log('  --cursor        Install to Cursor only');
@@ -196,8 +238,9 @@ function cmdHelp() {
   console.log('  --yes, -y       Skip confirmation prompts');
   console.log('  --dry-run       Preview mode — no changes made');
   console.log('  --force         Overwrite existing configs');
-  console.log('  --project PATH  Initialize a project');
+  console.log('  --project PATH  Initialize a project (legacy alias for "atool init")');
   console.log('  --analyze PATH  Prepare project for deep analysis');
+  console.log('  --stack STACK   Specify tech stack (e.g., react, vue, java)');
 }
 
 // ── Main ─────────────────────────────────────────────────────────────────────
@@ -210,6 +253,9 @@ function main() {
     case 'i':
       cmdInstall(flags);
       break;
+    case 'init':
+      cmdInit(flags);
+      break;
     case 'update':
     case 'u':
       cmdUpdate(flags);

package/hooks/doc-sync-reminder

@@ -36,8 +36,8 @@ main() {
         FILE_PATH=$(printf '%s' "$INPUT" | grep -oE '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' 2>/dev/null | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//;s/"$//' || echo "")
     fi
 
-    # Only respond to Write/Edit
-    if [[ "$TOOL_NAME" != "Write" && "$TOOL_NAME" != "Edit" ]]; then
+    # Only respond to Write/Edit/MultiEdit
+    if [[ "$TOOL_NAME" != "Write" && "$TOOL_NAME" != "Edit" && "$TOOL_NAME" != "MultiEdit" ]]; then
         exit 0
     fi
 
@@ -120,9 +120,9 @@ main() {
         fi
     fi
 
-    # If no stale doc detection available, always remind (conservative)
+    # If no stale doc detection available, exit silently (consistent with task-state-tracker fallback)
     if ! $_LIB_FOUND; then
-        STALE=true
+        exit 0
     fi
 
     if ! $STALE; then

package/hooks/hooks-cursor.json

@@ -22,6 +22,17 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.cursor/hooks/atool-pre-commit"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
@@ -31,6 +42,15 @@
             "command": "bash ~/.cursor/hooks/atool-doc-sync-reminder"
           }
         ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.cursor/hooks/atool-task-state-tracker"
+          }
+        ]
       }
     ]
   }

package/hooks/hooks.json

@@ -22,15 +22,35 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.claude/hooks/atool-pre-commit"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
-        "matcher": "Write|Edit",
+        "matcher": "Write|Edit|MultiEdit",
         "hooks": [
           {
             "type": "command",
             "command": "bash ~/.claude/hooks/atool-doc-sync-reminder"
           }
         ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.claude/hooks/atool-task-state-tracker"
+          }
+        ]
       }
     ]
   }

package/hooks/pre-commit

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+# aTool - hooks/pre-commit
+# PreToolUse hook: enforces quality standards before git commit
+# Checks: TODO/FIXME leftovers, sensitive files, conventional commits, large files
+
+set -euo pipefail
+
+# Detect which IDE is running this hook
+HOOK_IDE="claude"
+if [[ -n "${CURSOR_PLUGIN_ROOT:-}" ]]; then
+    HOOK_IDE="cursor"
+fi
+
+# Escape string for JSON embedding
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+# Read JSON from stdin (Claude Code provides tool input on stdin)
+INPUT=""
+if [[ ! -t 0 ]]; then
+    INPUT=$(cat)
+fi
+
+# Extract tool_name and command from tool input
+TOOL_NAME=""
+TOOL_INPUT=""
+if command -v jq &>/dev/null && [[ -n "$INPUT" ]]; then
+    TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null || echo "")
+    TOOL_INPUT=$(printf '%s' "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null || echo "")
+fi
+
+# Only intercept git commit commands
+if [[ "$TOOL_NAME" != "Bash" ]]; then
+    exit 0
+fi
+if [[ -z "$TOOL_INPUT" ]]; then
+    exit 0
+fi
+
+# Check if this is a git commit command
+TOOL_INPUT_LOWER=$(printf '%s' "$TOOL_INPUT" | tr '[:upper:]' '[:lower:]')
+IS_GIT_COMMIT=false
+if printf '%s' "$TOOL_INPUT_LOWER" | grep -qE 'git\s+commit'; then
+    IS_GIT_COMMIT=true
+fi
+
+if ! $IS_GIT_COMMIT; then
+    exit 0
+fi
+
+# ── Pre-commit checks ─────────────────────────────────────────────────────
+
+WARNINGS=""
+CHECKS_FAILED=0
+PROJECT_DIR="${PWD:-}"
+
+# 1. Check for TODO/FIXME in staged files (AI "lazy" patterns)
+TODO_COUNT=0
+if command -v git &>/dev/null && git rev-parse --is-inside-work-tree &>/dev/null; then
+    STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM 2>/dev/null || echo "")
+    if [[ -n "$STAGED_FILES" ]]; then
+        for file in $STAGED_FILES; do
+            if [[ -f "$PROJECT_DIR/$file" ]]; then
+                local_count=$(grep -cE '(TODO|FIXME|HACK|XXX)' "$PROJECT_DIR/$file" 2>/dev/null || echo "0")
+                if [[ "$local_count" -gt 0 ]]; then
+                    TODO_COUNT=$((TODO_COUNT + local_count))
+                fi
+            fi
+        done
+    fi
+fi
+
+if [[ "$TODO_COUNT" -gt 0 ]]; then
+    WARNINGS+="- Found ${TODO_COUNT} TODO/FIXME/HACK/XXX marker(s) in staged files. Consider resolving before commit.\n"
+    CHECKS_FAILED=$((CHECKS_FAILED + 1))
+fi
+
+# 2. Check for sensitive files in staged changes
+SENSITIVE_PATTERNS="(\.env$|\.env\.|credentials|\.pem$|\.key$|secret|\.p12$|\.pfx$|id_rsa|id_ed25519|\.npmrc$|\.pypirc$)"
+SENSITIVE_FOUND=""
+if command -v git &>/dev/null && git rev-parse --is-inside-work-tree &>/dev/null; then
+    if [[ -n "${STAGED_FILES:-}" ]]; then
+        for file in $STAGED_FILES; do
+            if printf '%s' "$file" | grep -qE "$SENSITIVE_PATTERNS" 2>/dev/null; then
+                if [[ -z "$SENSITIVE_FOUND" ]]; then
+                    SENSITIVE_FOUND="$file"
+                else
+                    SENSITIVE_FOUND="$SENSITIVE_FOUND, $file"
+                fi
+            fi
+        done
+    fi
+fi
+
+if [[ -n "$SENSITIVE_FOUND" ]]; then
+    WARNINGS+="- BLOCKED: Sensitive file(s) detected in commit: ${SENSITIVE_FOUND}. Do NOT commit secrets.\n"
+    CHECKS_FAILED=$((CHECKS_FAILED + 10))  # High severity
+fi
+
+# 3. Check conventional commit message format
+# Note: PreToolUse hook runs BEFORE commit happens, so we can only extract from command line.
+# However, commit message extraction from bash command is unreliable for heredoc format.
+# This check is best-effort only. Use PostToolUse hook for reliable validation after commit.
+COMMIT_MSG=""
+if printf '%s' "$TOOL_INPUT" | grep -qE '\-m'; then
+    # Try to extract message after -m flag (only works for simple quoted messages)
+    COMMIT_MSG=$(printf '%s' "$TOOL_INPUT" | sed -n 's/.*-m[[:space:]]*\(['"'"'"][^'"'"'"]*['"'"'"]\|"[^"]*"\|\S\+\).*/\1/p' 2>/dev/null | head -1 || echo "")
+    # Strip surrounding quotes
+    COMMIT_MSG="${COMMIT_MSG#\"}"
+    COMMIT_MSG="${COMMIT_MSG%\"}"
+    COMMIT_MSG="${COMMIT_MSG#\'}"
+    COMMIT_MSG="${COMMIT_MSG%\'}"
+fi
+
+# Only warn if message extraction succeeded AND it doesn't match pattern
+# (If extraction fails, skip validation — will be checked post-commit by PostToolUse hook)
+if [[ -n "$COMMIT_MSG" ]] && [[ ! "$COMMIT_MSG" =~ \$\(cat ]]; then
+    CONVENTIONAL_PATTERN='^(feat|fix|docs|test|refactor|chore|style|perf|build|ci|revert|release)(\(.+\))?:'
+    if ! printf '%s' "$COMMIT_MSG" | grep -qE "$CONVENTIONAL_PATTERN" 2>/dev/null; then
+        WARNINGS+="- Commit message does not follow Conventional Commits: '${COMMIT_MSG}'\n"
+        WARNINGS+="  Expected: feat|fix|docs|test|refactor|chore|style|perf|build|ci|revert|release[(scope)]: description\n"
+        # This is a warning, not a hard block
+    fi
+else
+    # If commit message extraction failed or detected heredoc, add note about post-validation
+    if printf '%s' "$TOOL_INPUT" | grep -qE '\-m.*\$\(cat'; then
+        WARNINGS+="- INFO: Using heredoc commit message format. Conventional Commits validation will be performed post-commit.\n"
+    fi
+fi
+
+# 4. Check for large files (> 1MB) in staged changes
+LARGE_FILES=""
+if command -v git &>/dev/null && git rev-parse --is-inside-work-tree &>/dev/null; then
+    if [[ -n "${STAGED_FILES:-}" ]]; then
+        for file in $STAGED_FILES; do
+            if [[ -f "$PROJECT_DIR/$file" ]]; then
+                file_size=$(wc -c < "$PROJECT_DIR/$file" 2>/dev/null || echo "0")
+                # 1MB = 1048576 bytes
+                if [[ "$file_size" -gt 1048576 ]]; then
+                    size_mb=$((file_size / 1048576))
+                    if [[ -z "$LARGE_FILES" ]]; then
+                        LARGE_FILES="$file (${size_mb}MB)"
+                    else
+                        LARGE_FILES="$LARGE_FILES, $file (${size_mb}MB)"
+                    fi
+                fi
+            fi
+        done
+    fi
+fi
+
+if [[ -n "$LARGE_FILES" ]]; then
+    WARNINGS+="- WARNING: Large file(s) in commit: ${LARGE_FILES}. Consider using .gitattributes or Git LFS.\n"
+fi
+
+# ── Output ────────────────────────────────────────────────────────────────
+
+if [[ "$CHECKS_FAILED" -gt 0 ]] || [[ -n "$WARNINGS" ]]; then
+    SEVERITY="WARNING"
+    if [[ "$CHECKS_FAILED" -ge 10 ]]; then
+        SEVERITY="BLOCKED"
+    fi
+
+    _MSG="<ATOOL-PRE-COMMIT-CHECK>\n"
+    _MSG+="${SEVERITY}: Pre-commit quality checks found issues:\n\n"
+    _MSG+="$WARNINGS"
+    _MSG+="\n"
+
+    if [[ "$SEVERITY" == "BLOCKED" ]]; then
+        _MSG+="**This commit is BLOCKED.** Fix the critical issues above before proceeding.\n"
+    else
+        _MSG+="Please review the warnings above. You may proceed if they are acceptable, but consider addressing them.\n"
+    fi
+    _MSG+="</ATOOL-PRE-COMMIT-CHECK>"
+
+    if [[ "$HOOK_IDE" == "cursor" ]]; then
+        _ESCAPED=$(escape_for_json "$_MSG")
+        printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "PreToolUse",\n    "additionalContext": "%s"\n  }\n}\n' "$_ESCAPED"
+    else
+        printf '%b' "$_MSG"
+    fi
+fi
+
+exit 0

package/hooks/prompt-guard

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # aTool - hooks/prompt-guard
-# Lightweight UserPromptSubmit hook: reminds AI to clarify before implementing
-# Skips short/trivial prompts, triggers on substantial implementation requests
+# UserPromptSubmit hook: reminds AI to clarify before implementing
+# v2: Tightened skip conditions, structured template injection for Tier 2+
 
 set -euo pipefail
 
@@ -57,45 +57,41 @@ if printf '%s' "$PROMPT" | LC_ALL=C grep -q '[一-龥]' 2>/dev/null; then
     HAS_CJK=true
 fi
 
-# 1. Short messages
-if $HAS_CJK && [[ "$PROMPT_LEN" -lt 8 ]]; then
+# 1. Short messages — TIGHTENED: lower thresholds
+#    Old: CJK < 8, Latin < 20
+#    New: CJK < 6, Latin < 15 (pure short replies like "ok", "好")
+if $HAS_CJK && [[ "$PROMPT_LEN" -lt 6 ]]; then
     exit 0
-elif ! $HAS_CJK && [[ "$PROMPT_LEN" -lt 20 ]]; then
+elif ! $HAS_CJK && [[ "$PROMPT_LEN" -lt 15 ]]; then
     exit 0
 fi
 
-# 2. Follow-up replies (affirmative, no new intent)
-FOLLOW_UP_PATTERNS="^(yes|ok|okay|好的|继续|继续做|go ahead|sure|yep|yeah|pls|please|go on|继续吧|对|嗯|是的|行|可以)$"
-if printf '%s' "$PROMPT_LOWER" | grep -qE "$FOLLOW_UP_PATTERNS" 2>/dev/null; then
+# 2. Pure confirmations only — TIGHTENED: strict single-word matches
+#    Old: included multi-word phrases like "go ahead", "pls", "please"
+#    New: only exact single-word affirmative replies
+PURE_CONFIRMATIONS="^(yes|ok|okay|好的|继续|对|嗯|是的|行|可以|sure|yep|yeah|done|go|next)$"
+if printf '%s' "$PROMPT_LOWER" | grep -qE "$PURE_CONFIRMATIONS" 2>/dev/null; then
     exit 0
 fi
 
-# 3. User asking a question (ends with ? or ？)
-if printf '%s' "$PROMPT" | grep -qE '[?？]$' 2>/dev/null; then
-    exit 0
-fi
-
-# 4. Meta-commands (non-implementation requests)
-# Note: Ambiguous words like "build", "test", "deploy" are NOT listed here
-# because they could be feature requests (e.g., "build a dashboard")
-META_COMMANDS="^(commit|git |run |npm |yarn |pnpm |bun |cargo |go run|python |pytest|jest|vitest|explain|diff |show |list |check |lint |format |log |tail |grep |find |cat |head )"
-if printf '%s' "$PROMPT_LOWER" | grep -qE "$META_COMMANDS" 2>/dev/null; then
-    exit 0
-fi
-
-# 5. Exit signals (user wants to skip clarification)
+# 3. Exit signals (user explicitly wants to skip clarification) — KEPT as-is
 EXIT_SIGNALS="(别问了|不要问|别再问|直接做|直接实现|直接开始|不用确认|跳过提问|不要确认|just do it|stop asking|no questions|don.t ask|skip asking|go ahead and implement)"
 if printf '%s' "$PROMPT_LOWER" | grep -qE "$EXIT_SIGNALS" 2>/dev/null; then
     exit 0
 fi
 
-# ── Trigger conditions ───────────────────────────────────────────────────
+# ── REMOVED: Old skip conditions that were too broad ───────────────────────
+# OLD: "Questions ending with ?" → REMOVED (questions like "能帮我实现一个搜索功能吗？" should trigger)
+# OLD: "Meta-commands (commit, run, npm, explain...)" → REMOVED
+#      ("build a dashboard" starts with "build" but is a feature request)
+#      ("run the migration to add new user fields" is an implementation request)
+
+# ── Classify task complexity ──────────────────────────────────────────────
 
 # Count words: for CJK text (no spaces), count CJK chars as words;
 # for Latin text, count whitespace-separated tokens
 WORD_COUNT=0
 if $HAS_CJK; then
-    # CJK: count CJK characters (use LC_ALL=C for locale safety)
     CJK_COUNT=$(printf '%s' "$PROMPT" | LC_ALL=C grep -o '[一-龥]' 2>/dev/null | wc -l | tr -d '[:space:]')
     WORD_COUNT=$((CJK_COUNT))
 else
@@ -104,25 +100,78 @@ else
     done
 fi
 
-# Trigger: sufficient length + enough words/CJK chars + implementation keyword
-IMPLEMENT_KEYWORDS="(开发|创建|新增|实现|添加|加个|做一个|写一个|build|create|add|implement|make|develop|design|feature|refactor|extract|integrate|support|handle)"
+# Detect implementation intent keywords
+# Extended with common natural language patterns (CJK + English)
+IMPLEMENT_KEYWORDS="(开发|创建|新增|实现|添加|加个|做一个|写一个|重构|优化|修改|调整|修复|集成|迁移|设计|拆分|改造|搭建|编写|扩展|帮我|需要|能不能|可以|请|麻烦|给我|加上|看看|想要|build|create|add|implement|make|develop|design|feature|refactor|extract|integrate|support|handle|fix|migrate|modify|update|change|enhance|improve|help.me|show.me|please|create.a|build.a|write.a|let.me|could.you|can.you)"
+
+HAS_IMPLEMENT=false
 LENGTH_OK=false
-if $HAS_CJK && [[ "$PROMPT_LEN" -ge 8 ]]; then
+
+if $HAS_CJK && [[ "$PROMPT_LEN" -ge 6 ]]; then
     LENGTH_OK=true
-elif ! $HAS_CJK && [[ "$PROMPT_LEN" -ge 20 ]]; then
+elif ! $HAS_CJK && [[ "$PROMPT_LEN" -ge 15 ]]; then
     LENGTH_OK=true
 fi
 
-if $LENGTH_OK && [[ "$WORD_COUNT" -gt 5 ]] && \
-   printf '%s' "$PROMPT_LOWER" | grep -qE "$IMPLEMENT_KEYWORDS" 2>/dev/null; then
-    _REMINDER='<system-reminder>
+if printf '%s' "$PROMPT_LOWER" | grep -qE "$IMPLEMENT_KEYWORDS" 2>/dev/null; then
+    HAS_IMPLEMENT=true
+fi
+
+# ── Determine tier and output ─────────────────────────────────────────────
+
+if $LENGTH_OK && $HAS_IMPLEMENT && [[ "$WORD_COUNT" -gt 3 ]]; then
+    # Determine complexity tier
+    TIER=0
+
+    # Tier 3 indicators: architecture-level, multi-module, system-wide
+    TIER3_KEYWORDS="(架构|系统|整体|全面|重新设计|从零|微服务|拆分|architecture|system.redesign|from scratch|microservice|monolith|break down|overhaul)"
+    # Tier 2 indicators: new feature, multi-step, unclear scope
+    TIER2_KEYWORDS="(功能|模块|页面|组件|接口|服务|支持|feature|module|page|component|endpoint|service|support|workflow|pipeline|dashboard|integration)"
+
+    if printf '%s' "$PROMPT_LOWER" | grep -qE "$TIER3_KEYWORDS" 2>/dev/null; then
+        TIER=3
+    elif printf '%s' "$PROMPT_LOWER" | grep -qE "$TIER2_KEYWORDS" 2>/dev/null; then
+        TIER=2
+    else
+        TIER=1
+    fi
+
+    # Fallback tier escalation: if message has pronouns + concrete request context, bump tier
+    # This catches natural language requests without explicit keywords
+    if [[ "$TIER" -eq 1 ]] && [[ "$PROMPT_LEN" -gt 30 ]]; then
+        if printf '%s' "$PROMPT_LOWER" | grep -qE "(我|my|我们|our|帮|help|想|want|需要|need|能|can|可以|able)" 2>/dev/null; then
+            # Check if there are specific code/file references (suggests implementation request)
+            if printf '%s' "$PROMPT" | grep -qE "(\\.\\w+|/\\w+|\\{\\w+\\}|function|class|method|endpoint)" 2>/dev/null; then
+                TIER=2
+            fi
+        fi
+    fi
+
+    # Build tier-appropriate reminder
+    if [[ "$TIER" -ge 2 ]]; then
+        # Tier 2+: Structured template — require analysis before implementation
+        _REMINDER="<system-reminder>
+**TIER ${TIER} TASK DETECTED** — This is a ${TIER}-level task. Before writing ANY code:
+
+1. **Analyze** — Read relevant source files first (CLAUDE.md, package.json, existing patterns)
+2. **Classify** — Confirm complexity: Tier ${TIER} = $([ "$TIER" -eq 2 ] && echo "3-5 clarification questions" || echo "delegate to /brainstorming")
+3. **Clarify** — Ask context-aware questions about: $([ "$TIER" -eq 2 ] && echo "scope, edge cases, existing patterns, acceptance criteria" || echo "architecture, constraints, trade-offs, migration strategy")
+4. **Plan** — Write implementation plan BEFORE touching code
+
+Do NOT jump to implementation. Read first, ask second, plan third, code last.
+See /clarify-before-build for full methodology.
+</system-reminder>"
+    else
+        # Tier 1: Lightweight reminder
+        _REMINDER='<system-reminder>
 Before implementing, classify task complexity and clarify requirements if needed:
-- Tier 0 (direct): single-value change → just do it
-- Tier 1 (1-2 questions): small change with ambiguity → ask key questions
-- Tier 2 (3-5 questions): new feature → read project files first, then ask context-aware questions
-- Tier 3: architecture-level → delegate to /brainstorming
+- Tier 0 (direct): single-value change, typo, format fix -> just do it
+- Tier 1 (1-2 questions): small change with ambiguity -> ask key questions
+- Tier 2 (3-5 questions): new feature, medium complexity -> structured clarification
+- Tier 3: architecture-level, vague requirements -> delegate to /brainstorming
 See /clarify-before-build for full methodology.
 </system-reminder>'
+    fi
 
     if [[ "$HOOK_IDE" == "cursor" ]]; then
         _ESCAPED=$(escape_for_json "$_REMINDER")

package/hooks/session-start

@@ -245,26 +245,48 @@ if [[ -n "$DOC_SYNC" ]]; then
     INJECTION+=$'\n\n'
 fi
 
-INJECTION+="<ATOOL-CLARIFY-RULE>"
-INJECTION+=$'\n'
-INJECTION+="Before implementing ANY feature, first classify task complexity:"
-INJECTION+=$'\n'
-INJECTION+="Tier 0 (direct): single-value change, typo, format fix -> just do it"
+# Only inject clarify rule if in a code project (detected by presence of common project files)
+if [[ -f "package.json" || -f "pom.xml" || -f "go.mod" || -f "Cargo.toml" || -f "requirements.txt" || -f "build.gradle" || -f ".gradle" || -f "setup.py" || -f "Gemfile" ]]; then
+    INJECTION+="<ATOOL-CLARIFY-RULE>"
+    INJECTION+=$'\n'
+    INJECTION+="Before implementing ANY feature, first classify task complexity:"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 0 (direct): single-value change, typo, format fix -> just do it"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 1 (1-2 questions): small change with ambiguity -> ask key questions"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 2 (3-5 questions): new feature, medium complexity -> structured clarification"
+    INJECTION+=$'\n'
+    INJECTION+="Tier 3: architecture-level, vague requirements -> delegate to /brainstorming"
+    INJECTION+=$'\n'
+    INJECTION+="Rules: Read project files BEFORE asking (CLAUDE.md, package.json, source code). Never assume installed libs or existing patterns. Ask context-aware questions, not obvious ones."
+    INJECTION+=$'\n'
+    INJECTION+="Exit: If user says '别问了'/'直接做'/'just do it'/'stop asking' -> skip all questions, Tier 0."
+    INJECTION+=$'\n'
+    INJECTION+="See /clarify-before-build for full methodology."
+    INJECTION+=$'\n'
+    INJECTION+="</ATOOL-CLARIFY-RULE>"
+    INJECTION+=$'\n'
+fi
+
+# Inject language rule (always, for all projects)
+INJECTION+="<ATOOL-LANGUAGE-RULE>"
 INJECTION+=$'\n'
-INJECTION+="Tier 1 (1-2 questions): small change with ambiguity -> ask key questions"
+INJECTION+="语言要求 (Language Requirement):"
 INJECTION+=$'\n'
-INJECTION+="Tier 2 (3-5 questions): new feature, medium complexity -> structured clarification"
+INJECTION+="- 项目文档 (docs/, README, 架构指南): 必须中文"
 INJECTION+=$'\n'
-INJECTION+="Tier 3: architecture-level, vague requirements -> delegate to /brainstorming"
+INJECTION+="- SKILL.md: 保持英文（AI 指令文件）"
 INJECTION+=$'\n'
-INJECTION+="Rules: Read project files BEFORE asking (CLAUDE.md, package.json, source code). Never assume installed libs or existing patterns. Ask context-aware questions, not obvious ones."
+INJECTION+="- Commit message: 推荐中文"
 INJECTION+=$'\n'
-INJECTION+="Exit: If user says '别问了'/'直接做'/'just do it'/'stop asking' -> skip all questions, Tier 0."
+INJECTION+="- 代码注释: 可中文或英文（跟随代码风格）"
 INJECTION+=$'\n'
-INJECTION+="See /clarify-before-build for full methodology."
+INJECTION+="如果误用英文写项目文档，请用 /doc-coauthoring 重写为中文。"
 INJECTION+=$'\n'
-INJECTION+="</ATOOL-CLARIFY-RULE>"
+INJECTION+="</ATOOL-LANGUAGE-RULE>"
 INJECTION+=$'\n'
+
 INJECTION+="</ATOOL-SESSION>"
 INJECTION+=$'\n'
 INJECTION+="</EXTREMELY_IMPORTANT>"