From 165efc62b046dc96c5c1d7b62d7da0dc86274c61 Mon Sep 17 00:00:00 2001 From: Chaim Date: Sat, 30 May 2026 11:19:47 +0000 Subject: [PATCH] docs(claude): correct canonical tasks.json path + add CLI cwd footgun warning TaskMaster's --tag selects the logical group inside a file, not which tasks.json to write; the CLI resolves the file from cwd. Document the canonical project-root-relative path and the cwd footgun. Co-Authored-By: Claude Opus 4.8 (1M context) --- CLAUDE.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index ea76897..103d34c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -163,12 +163,14 @@ הפרויקט משתמש ב-**TaskMaster AI** (MCP server) לניהול משימות מובנה: - **תמיד** להשתמש ב-TaskMaster לפירוק, מעקב וניהול משימות — לא ב-TASKS.md ידני -- קובץ המשימות: `tasks/tasks.json` +- קובץ המשימות הקנוני: `~/legal-ai/.taskmaster/tasks/tasks.json` (יחסי ל-project root, **לא** `~/.taskmaster/tasks/tasks.json`). מכיל את כל ה-tags של legal-ai (`master`, `legal-ai`). - פקודות עיקריות: `get_tasks`, `next_task`, `add_task`, `update_task`, `expand_task` - לפני התחלת עבודה → `next_task` כדי לדעת מה הבא לפי תלויות - אחרי סיום משימה → `update_task` עם status=done - משימה מורכבת → `expand_task` לפירוק לתתי-משימות +> **⚠️ מלכוד cwd ב-CLI:** הדגל `--tag` בוחר קבוצה לוגית *בתוך* הקובץ — הוא **לא** בוחר לאיזה `tasks.json` לכתוב. ה-CLI מאתר את הקובץ לפי ה-cwd (`/.taskmaster/tasks/tasks.json`). תמיד `cd ~/legal-ai` לפני `task-master add-task` או כל פקודה משנה, ואז אמת ב-MCP `get_tasks` שהשינוי נחת. הרצה מ-`~/` כותבת לקובץ נטוש והמשימה לא תופיע בשאילתות MCP. כשלא בטוחים — לערוך את `~/legal-ai/.taskmaster/tasks/tasks.json` ישירות. + --- ## Paperclip — כללי אינטגרציה קריטיים