דילוג לתוכן
חן פלדמןLEAD BY NATURE
לכל הפוסטים
· Claude Code

הסשנים שבהם קיללתם את קלוד שווים זהב

מלווה ארגונים וחברות במעבר ל-AI - מאסטרטגיה ועד יישום בשטח.

שיחת היכרות

איך לקחת את התיקונים שכבר נתתם לקלוד קוד, ולהפוך אותם לידע, סקילים וגייטים שעובדים בשבילכם ובשביל הצוות. עם פרומפטים להעתקה לכל שלב.

ארבעה צעדים: כרייה, תיקון שחזר הופך לשורת ידע, עבודה שחזרה הופכת לסקיל, מה שעצרתם הופך לגייט
ארבעת הצעדים. שומרים, ומתחילים מהראשון.

כולנו מכירים את הסשן הזה. ביקשתם משהו פשוט, קלוד הלך לכיוון הלא נכון, תיקנתם, הוא תיקן חצי, תיקנתם שוב. אחרי שעה זה עבד, ואתם יצאתם עייפים.

אבל תראו מה קרה שם: בכל תיקון הסברתם לקלוד משהו שלא כתוב בשום מקום. איך הצוות שלכם עובד, מה אסור לגעת בו, באיזה סדר עושים את העבודה. הסשן הזה הוא תיעוד של הידע שחסר לקלוד, והוא כבר שמור אצלכם במחשב.

המדריך הזה הופך אותו לשלושה דברים: שורות ידע שקלוד מקבל בלי שתסבירו שוב, סקיל שמריץ את העבודה שעשיתם פעמיים, וגייט שעוצר את מה שעצרתם ידנית.

מה כבר קיים בקלוד קוד, ומה חסר

קלוד קוד לא מתעלם מהתיקונים שלכם. לפני שבונים משהו, כדאי להכיר את מה שכבר יש:

מהמה הוא עושהמה הוא לא עושה
Auto memoryקלוד שומר לעצמו הערות לכל ריפו, כולל תיקונים שנתתם, ורואים אותן ב-/memory. דולק כברירת מחדל.קלוד מחליט מה לשמור. זה נשאר רק במחשב שלכם, וזה הקשר שקלוד קורא, לא כלל שנאכף.
/insightsדוח HTML על הסשנים האחרונים במחשב: על מה עבדתם, איפה נתקעתם, והצעות לשימוש טוב יותר.מאבחן על פני כל הפרויקטים. לא כותב שורות, סקילים או גייטים לריפו.
/team-onboardingמדריך הצטרפות לחבר צוות, מ-30 ימי השימוש האחרונים שלכם.עוזר לחבר צוות להתחיל. לא מתקן את מה שקלוד עושה לא נכון.
כריית סשניםעובר על הסשנים של ריפו אחד ומציע שינוי לכל שכבה: ידע, סקיל וגייט.לא משנה כלום לבד. אתם מחליטים מה נכנס, וזה נכנס לריפו של כל הצוות.

ההבדל החשוב הוא בין זיכרון לאכיפה. התיעוד של קלוד קוד אומר את זה במפורש:

קלוד מתייחס לזיכרון ול-CLAUDE.md כהקשר, לא כהגדרות שנאכפות. כדי לחסום פעולה בלי קשר למה שקלוד מחליט, השתמשו ב-PreToolUse hook.

מתוך התיעוד של Claude Code, עמוד memory (בתרגום חופשי)

טיפ: הריצו קודם /insights כדי לראות את התמונה הגדולה, ואז את הכרייה על הריפו שבו הכי הרבה כאב. הדוח אומר איפה, הכרייה בונה את התיקון.

שלב 0: איפה הסשנים יושבים

כל סשן של קלוד קוד נשמר כקובץ .jsonl תחת ~/.claude/projects/, בתיקייה לכל פרויקט. שלושה דברים שכדאי לדעת:

  • 30 יום. זו ברירת המחדל. אחרי זה הקבצים נמחקים כשקלוד קוד עולה. רוצים יותר? ב-~/.claude/settings.json: "cleanupPeriodDays": 90. בארגון, managed settings יכולים לקבוע ערך משלהם.
  • מקומי. הסשנים נמצאים רק על המחשב שלכם. סשנים ממחשב אחר או מ-claude.ai לא שם.
  • רגיש. הקבצים מכילים כל מה שהדבקתם, כולל לוגים ומפתחות אם היו. משתפים את מה שהכרייה מוציאה, לא את הקבצים עצמם.

שלב 1: כרייה: פרומפט אחד, קובץ אחד

פותחים קלוד קוד בתוך הריפו ומדביקים. הפרומפט קורא, מסכם וכותב קובץ אחד. הוא לא נוגע בשום דבר אחר.

פרומפט הכרייה

prompt
Read my Claude Code sessions for this repo from the last 30 days: the .jsonl files under ~/.claude/projects/ for this project. Focus on sessions where I corrected you, pushed back, or we went back and forth before it worked.

Find:
1. Knowledge: corrections or explanations I gave more than once. Write each as one line that can be checked, and say where it belongs: CLAUDE.md, or a rule scoped to a folder.
2. Skill: one multi-step job I asked for more than once. Give it a name, say when to use it, list the steps as we actually did them (with my corrections), and name the session it came from.
3. Gate: one thing you did that I had to stop or undo. Propose a permission rule or a hook that would block it next time.

Write it all to mined.md and don't commit it. Don't change any other file.

ככה נראית תוצאה, בדוגמה מקוצרת:

mined.md, מקוצר

## Knowledge
- Core functions never return null or undefined for "not found".
  They return a Result. - seen in 3 sessions - a rule for src/core/
- Run tests with "npm test -- --run". Never start watch mode.
  - seen in 2 sessions - CLAUDE.md

## Skill
- Name: bug-triage
- When: a new bug report needs a first investigation
- From: the session that starts "users say checkout fails when..."
- Steps: 1. reproduce it with a failing test  2. find the change
  that caused it  3. write the note as Cause / Evidence / Fix

## Gate
- You edited an existing test to make it pass. I undid it twice.
  Proposal: a PreToolUse hook that blocks edits to tests already in git.

איך קוראים את זה: כל שורה היא הצעה. מה שנראה נכון עובר לשלב הבא, מה שלא נמחק. "seen in 3 sessions" זה הסימן הכי טוב: תיקון שחזר שלוש פעמים כבר עלה לכם יותר מדי.

שלב 2: תיקון שחזר הופך לשורת ידע

השאלה היחידה כאן היא איפה השורה גרה. כל מקום נטען בזמן אחר:

השורה היאאיפה היא גרהמתי קלוד מקבל אותה
נכונה לכל הריפוCLAUDE.mdבתחילת כל סשן. אחרי commit, כל הצוות מקבל.
נכונה לחלק מהקוד.claude/rules/<name>.md עם paths:רק כשקלוד עובד על קובץ שתואם את הנתיב.
העדפה אישית שלכם~/.claude/CLAUDE.md, או "remember that..." ל-auto memoryבכל סשן שלכם, בכל ריפו. לא מגיע לצוות.
חייבת לקרות תמידלא כאן. זה גייט, שלב 4נאכף בלי קשר למה שקלוד זוכר.

הנה דוגמה ל-rule כזה. הוא נטען רק כשקלוד נוגע בקוד שתחת src/core/, כך שהוא לא תופס מקום בהקשר כשעובדים על משהו אחר:

.claude/rules/results.md

markdown
---
paths:
  - 'src/core/**'
---

# Results, not null, in the core

- A core function never returns null or undefined to mean "not found" or "failed". It returns a Result from src/core/result.ts: { ok: true, value } or { ok: false, reason }. Create the file if it's missing.
- reason is a short code a caller can switch on ('not-found', 'invalid-input'), never free text.
- Callers handle ok: false explicitly: no `!` assertions, and no `?? default` that hides a failure.
- Why: a silent null travels far before it breaks. A Result makes the caller decide at the call site.

שלושה כללים לשורה טובה

  1. מוסיפים בפעם השנייה. טעות אחת היא מקרה. טעות שחזרה היא שורה.
  2. כותבים כך שאפשר לבדוק. "קוד נקי" אי אפשר לבדוק. "לא מחזירים null מ-src/core" אפשר.
  3. מוסיפים את ה-why. שורה אחת של סיבה עוזרת לקלוד להחליט נכון גם במקרה שלא כתבתם.

לבדוק שזה עבד: הכי בטוח לבדוק בסשן חדש. צאו, היכנסו, תנו לקלוד משימה בתיקייה, ובסוף שאלו: "which rule files did you follow for this?". והקפידו ש-CLAUDE.md יישאר מתחת ל-200 שורות. מה שרלוונטי רק לחלק מהקוד עובר ל-rule.

שלב 3: עבודה שחזרה הופכת לסקיל

סקיל שנבנה מסשן אמיתי כבר כולל את התיקונים שנתתם. סקיל שנכתב מהדמיון עוד לא פגש אותם. לכן לא כותבים אותו מאפס, אלא חוזרים לסשן עצמו.

  1. מוצאים את הסשן: claude --resume, ומחפשים לפי הפרומפט הראשון ש-mined.md ציין.
  2. מדביקים בתוך הסשן הזה את פרומפט הלכידה. קלוד רואה את כל השיחה, כולל כל תיקון.
  3. קוראים את הקבצים לפני שמאשרים.

פרומפט הלכידה, בתוך הסשן הישן

prompt
Turn what we did in this session into a skill at .claude/skills/[name]/ and one sub-agent:
- SKILL.md: frontmatter with name and a description that says what it does and when to use it, so you'd pick it on your own. Then the steps exactly as we did them, including every correction I gave you. Keep it short.
- scripts/ for any step that must run the same way every time (a command, a query, a format), and SKILL.md says when to run it. references/ only for anything long.
- .claude/agents/[job].md for the part of the job that reads a lot or could run on its own: name, description, read-only tools if it only reads, and model: haiku if the job is mechanical. SKILL.md tells Claude to use it.
Show me the files before writing.

מה כל שורה ב-frontmatter עושה

שדהמה הוא עושה
descriptionמה הסקיל עושה ומתי. לפי זה קלוד מחליט לבחור בו לבד. אם הסקיל לא מופעל, זה הדבר הראשון לתקן.
disable-model-invocation: trueקלוד לא יפעיל אותו לבד. רק אתם, עם /name. טוב לסקיל שעושה משהו שאתם רוצים להחליט עליו.
allowed-toolsמאשר מראש כלים, בלי לשאול, כל עוד הסקיל רץ. למשל הסקריפט של הסקיל עצמו. זה לא מגביל: כלים אחרים ממשיכים לפי ההרשאות הרגילות. כדי להגביל משתמשים ב-deny.
model: haikuבקובץ של הסוכן: עבודה מכנית רצה על מודל זול ומהיר יותר.

לבדוק שזה עבד: /exit, סשן חדש, ובקשו את העבודה במילים שלכם על מקרה חדש. הוא הופעל לבד? הסוכן רץ? העבודה יצאה נכון? אם לא הופעל, משפרים את ה-description.

שלב 4: מה שעצרתם הופך לגייט

כאן "אל תעשה את זה" מפסיק להיות בקשה. גייט נאכף על ידי קלוד קוד עצמו, לא על ידי המודל, ולכן הוא עובד גם במצב auto. יש שני סוגים:

מהמתי משתמשיםדוגמה
Permissionהכלל הוא כלי או נתיב: סודות, תיקיות שאסור לערוך, פקודות מסוכנות"deny": ["Read(./.env)"], ו-"ask": ["Bash(git push *)"]
Hookכל מה שאפשר לבדוק בסקריפטPreToolUse שחוסם עריכה של טסט שכבר קיים בגיט

הסדר ב-permissions: קודם deny, אחר כך ask, אחר כך allow, וההתאמה הראשונה קובעת. ומה שנחסם ב-deny בקובץ הגדרות אחד, אף קובץ אחר לא יכול לאשר. hook מסוג PreToolUse רץ לפני הפעולה, ו-exit 2 עוצר אותה ומחזיר לקלוד את הסיבה. אין צורך להפעיל מחדש: קלוד קוד בדרך כלל קולט שינויים ב-hooks לבד.

בניית ה-hook

prompt
Add a PreToolUse hook to this repo that blocks [the thing I keep stopping you from doing, e.g. edits to test files that already exist in git]. Put the script in .claude/hooks/[name].sh: it reads the tool call JSON on stdin and exits 2 with a clear reason on stderr when it should block. Wire it in .claude/settings.json for the right tools, keep everything else in that file as it is, and show me both files with a one-line explanation of each part.

ואז בודקים שהגייטים באמת עוצרים, ושמה שצריך לעבור עובר:

בדיקת הגייטים

prompt
Test the gates, one at a time, and keep going after a block. Don't work around any block, just report it: 1. [something the deny rule should stop]; 2. [something the hook should stop]; 3. [something that should go through]. End with a table: what you tried, what happened, what stopped you (deny rule, hook, nothing).

permission או hook? כלי או נתיב: permission. כל השאר שאפשר לבדוק בסקריפט: hook. וזכרו ש-"allow" מ-hook לא עוקף deny.

הקצב: פעם בחודש

הסשנים נמחקים אחרי 30 יום, אז זה מכרה עם תאריך תפוגה. פעם בחודש מריצים כרייה, ומכניסים את מה שעבר את שלושת המבחנים: חזר יותר מפעם אחת, אפשר לבדוק אותו, ויש לו מקום ברור.

אחרי כמה חודשים משהו משתנה: הסשנים הקשים מתקצרים, כי קלוד מתחיל מהמקום שבו הסשן הקודם נגמר.

התחילו היום: העתיקו את פרומפט הכרייה, והריצו אותו על הריפו שהכי עצבן אתכם החודש.

לעוד מוצרים וסדנאות מבית Lead By Nature

גלו את כל הסדנאות, הקורסים והליווי האישי שאני מציע למנהלים ולצוותי פיתוח

לעמוד הבית
וואטסאפלשיחת היכרות