הרגלים
הרגלים הם תיקייה, .ingot/habits/, עם קובץ Markdown אחד לכל סוג תיקון: bug.md, defect.md, design.md, performance.md, tests.md, security.md, refactor.md, general.md, וכל סוג שתוסיפו. כל קובץ שומר ידע מתמשך להרצות הבאות: החלטות, דפוסים ו"תמיד לעשות X כש-Y", שורת תבליט אחת לכל רשומה. הסוכן קורא את הקבצים שמתאימים למשימה ומוסיף את מה שלמד לקובץ המתאים. עשו commit לתיקייה, וכל הסוכנים של הצוות לומדים יחד.
Beta Habits הוא פיצ'ר אופציונלי, והוא כבוי עד שמפעילים אותו. כשהוא כבוי הסוכן לא קורא ולא כותב לתיקייה; הקבצים נשארים במקומם. חוקים אומרים איך לכתוב קוד; הרגלים הם מה שהסוכן למד על העבודה בפרויקט הזה.


הפעלה
את Habits מוצאים בשלוש דרכים, כמו כל פיצ'ר אופציונלי:
- הצעה בצ'אט. כשה-prompt שלכם אומר משהו מתמשך ("From now on, always add a regression test when fixing a crash"), מתאר שגרה ("every time we release: bump the version, update the changelog, then tag the commit"), או כשבפרויקט כבר יש הרגלים של הצוות בזמן ש-Habits כבוי, כרטיס קטן מעל תיבת הצ'אט מציע Enable Habits. **×** מסתיר אותו לתמיד.
- Settings › Features › Habits. מתג הפעלה. אותו מתג הוא Use habits בראש עמוד Habits.
- הכפתור Habits בשורת המצב. לחיצה אחת מפעילה את Habits ופותחת את עמוד Habits; הוא מעומעם כש-Habits כבוי. הקיצור הוא
⌥⇧⌘`ב-macOS ו-Ctrl+Alt+Shift+`ב-Windows וב-Linux, ו-Habits: Turn On and Open ו-Habits: Turn On or Off נמצאות ב-Find Action.
הפעלת Habits יוצרת את .ingot/habits/ עם קובצי ברירת המחדל שחסרים. היא אף פעם לא דורסת קובץ, וכל עוד Habits נשאר פעיל, קובץ סוג שמחקתם נשאר מחוק.






קובצי הסוגים
| קובץ | מה נכנס אליו |
|---|---|
bug.md | תיקוני באגים: משהו קורס, זורק שגיאה או נותן תוצאה שגויה |
defect.md | פגמים מול האפיון: זה עובד, אבל לא כמו שכתוב בטיקט או בתנאי הקבלה |
design.md | UI ו-UX: פריסה, עיצוב, ערכות נושא, אייקונים, נגישות |
performance.md | מהירות ומשאבים: השהיה, זיכרון, רינדור, מטמון, גודל ה-bundle |
tests.md | בדיקות יחידה ו-end-to-end: מה לכסות, איך לכתוב אותן, בדיקות לא יציבות |
security.md | סודות, הזדהות וטיפול בקלט: אף פעם לא לדלוף, תמיד לאמת |
refactor.md | שינוי מבנה בלי לשנות התנהגות: שמות, חילוץ, כפילויות, קוד מת |
general.md | כל השאר ששווה לשמור: מוסכמות הפרויקט, תהליך העבודה, החלטות |
קובץ סוג הוא Markdown רגיל. ה-frontmatter אומר במה הסוג עוסק; ה-keywords קובעות לאילו משימות הוא מתאים. כל תבליט - בגוף הוא רשומה אחת.
---
description: Bug fixes: something crashes, throws or gives the wrong result.
keywords: [bug, crash, broken, error, exception, regression, stack trace, throw, null, undefined, fail]
---
# Bug
Lasting knowledge for future runs. One bullet per entry.
- Always add a regression test before fixing a crash
- Reproduce it in a failing test first
סוגים משלכם עובדים אותו דבר: i18n.md עם keywords: [locale, translation] נקרא בעבודה על תרגומים.
איך הסוכן קורא אותם
בכל בקשה Ingot נותנת ציון לכל קובץ סוג שיש בו רשומות מול ה-prompt: שם הסוג שווה 2 נקודות וכל אחת מה-keywords שלו נקודה אחת. הסוכן מקבל את הרשומות של 3 הסוגים הטובים ביותר (לכל היותר 30 הרשומות האחרונות של כל אחד) ושל general.md, שאותו הוא קורא תמיד. הוא מקבל גם את רשימת כל קובצי הסוגים עם מספר הרשומות בהם, כדי לפתוח קובץ נוסף אם מתברר שהמשימה נוגעת בו.
ל-"Another crash on the cart page" הסוכן קורא את bug.md; ל-"Make the header spacing tighter" הוא קורא את design.md, והידע על קריסות נשאר מחוץ ל-prompt.
איך הסוכן כותב אליהם
כשהסוכן לומד משהו ששווה לשמור, הוא מוסיף שורה לתשובה שלו:
HABIT: [bug] Always add a regression test before fixing a crash
HABIT: Never log access tokens in the payment client
Ingot מוציאה את השורות האלה מהתשובה ומוסיפה כל אחת לקובץ הסוג שלה. סוג עם שם הולך לקובץ הזה (שם חדש יוצר קובץ חדש); בלי סוג, Ingot מסווגת את הרשומה לפי אותו ניקוד, כך שהשורה השנייה נכנסת ל-security.md. רשומה שכבר קיימת בקובץ לא נוספת פעמיים, ושורות בתוך בלוקי קוד לא נוגעים בהן.
כל שמירה מציגה בצ'אט הערה כסופה Saved to Habits עם הקובץ והרשומה. לחיצה על ההערה מציגה את הקובץ בעמוד Habits, Open פותח אותו בלשונית עורך, ו-Undo מוציא את הרשומה מהקובץ.
כדי שהסוכן יקרא את הקבצים אבל לעולם לא יכתוב אליהם, כבו את Agent adds what it learns to the type files בעמוד Habits (ingot.habits.knowledge.autoSave).
עריכת הקבצים בעמוד Habits
Settings › Tools › Habits מציג את התיקייה תחת Knowledge by type: כל קובץ עם התיאור ומספר הרשומות שלו. לחצו על קובץ כדי לערוך אותו במקום; המונה מתעדכן בזמן ההקלדה. אייקון החץ פותח אותו בלשונית עורך. Escape או Cancel סוגרים את העורך בלי לשמור.


**+ Add type** יוצר קובץ סוג חדש. השתמשו באותיות, מספרים ומקפים; Bugs נדחה כש-bug.md כבר קיים.


שמירת ידע מה-prompt
כשה-prompt שלכם אומר משהו מתמשך בזמן ש-Habits כבוי, ההצעה מציינת את הקובץ שאליו הוא שייך: Keep this in .ingot/habits/bug.md so the agent follows it in every future run. Enable Habits מפעיל את Habits, שומר את המשפט (בלי "From now on" או "please") בקובץ הזה ופותח אותו בעמוד Habits.


Playbooks לתרחישים
באותה תיקייה אפשר לשמור גם playbooks: קבצים עם frontmatter של when ו-steps לתרחיש כמו באג בתשלומים או release. כשמגיעה משימה מהסוג הזה, בצעו את הצעדים האלה, השתמשו בכלים האלה ואל תעצרו עד שהבדיקות האלה עוברות. עמוד Habits מציג אותם תחת Scenario playbooks, מתחת לקובצי הסוגים.


כשההצעה הגיעה משגרה ב-prompt, Enable Habits פותח playbook שנוסח ממנה: התרחיש הופך ל-when ולשם, וכל צעד ("…, then …", רשימה ממוספרת, או מה שאחרי נקודתיים) הופך לצעד. ערכו אותו, בחרו This project או Global ולחצו Add habit.




קובץ playbook
---
name: Payments bug
when: A bug report or failing test in the payments service
keywords: [payment, checkout, refund, invoice]
globs: ["services/payments/**"]
errorRegex: "PaymentError|CardDeclined"
steps:
- Reproduce the problem with a failing test in services/payments/test
- Search the service logs and recent commits for the error
- Fix the cause, not the symptom
- Run the payments test suite
allowedTools: [read_file, grep, glob, edit_file, ingot/run]
doneCriteria:
- The new test fails before the fix and passes after it
- npm test -w services/payments passes
---
Payments code handles money: never change rounding or currency logic without a test.
| שדה | משמעות |
|---|---|
name | מוצג בצ'אט (עד 64 תווים) |
when | התרחיש, במילים פשוטות; הסוכן קורא אותו כדי להחליט אם ה-playbook מתאים |
keywords | מילים ב-prompt שמצביעות על ה-playbook הזה |
globs | קבצים בהקשר שמצביעים על ה-playbook הזה |
errorRegex | תבנית שגיאה לחפש ב-prompt, בקבצים המצורפים, באבחונים ובפלט הטרמינל |
steps | רשימת הצעדים המסודרת שהסוכן מבצע (עד 20) |
allowedTools | הכלים שהסוכן רשאי להשתמש בהם כשה-playbook פעיל, כמו read_file, ingot/run או github/*; בלי השדה הכול מותר |
doneCriteria | בדיקות שהסוכן מאשר לפני שהוא מסיים |
טקסט אחרי ה-frontmatter נשלח יחד עם הצעדים כהערות נוספות. קובץ עם when או steps הוא תמיד playbook, אף פעם לא קובץ סוג.
איפה ה-playbooks נמצאים
| תיקייה | היקף |
|---|---|
.ingot/habits/*.md | הפרויקט הזה; משותף דרך Git |
~/.ingot/habits/*.md | כל הפרויקטים במחשב הזה |
.cursor/habits/*.md | נקרא לשם תאימות |
כששמות מתנגשים, הפרויקט גובר על .cursor/habits, שגובר על התיקייה הגלובלית. כיבוי playbook של הצוות עבורכם הוא הגדרה אישית; הוא לא משנה את הקובץ במאגר. קובצי סוגים נקראים רק מ-.ingot/habits/ של הפרויקט.
הרגלים עובדים בכל מבנה פרויקט. כשפותחים תת-תיקייה של ריפו, גם ה-playbooks שב-.ingot/habits של התיקיות שמעליה, עד שורש הריפו, נשמרים; אלה של התיקייה הפתוחה גוברים כשיש שם זהה, והרגלים חדשים נשמרים בה. אם נראה שהרגל לא נלקח בחשבון, Help › Ingot Health… › Project setup אומר אם Habits כבוי (עם כפתור Turn on Habits) או שקובץ הרגל לא נטען.
בחירה אוטומטית
בכל בקשה חדשה Ingot נותנת ציון לכל playbook מול מה שאתם עובדים עליו:
| סימן | נקודות |
|---|---|
errorRegex תואם שגיאה ב-prompt, בקבצים המצורפים, באבחונים או בטרמינל | 3 |
מילה מ-keywords מופיעה ב-prompt | 2 |
קובץ בהקשר תואם ל-globs | 1 |
נבחר ה-playbook הטוב ביותר עם 2 נקודות לפחות, כך שקובץ תואם לבדו אף פעם לא בוחר playbook. הסוכן יכול גם להחליף playbook בעצמו כשמתברר שהמשימה היא משהו אחר, ואתם יכולים לבחור או לכבות playbook בעצמכם.
הגלולה "Using habit"
כש-playbook פעיל, גלולה מעל תיבת הכתיבה מציגה Using habit: Payments bug ולמה הוא נבחר (למשל keyword "refund"). פתחו אותה כדי לראות את הרשימה החיה: הסוכן מסמן צעדים תוך כדי עבודה, ולפני שהוא מסיים הוא בודק את תנאי הסיום ומקבל תזכורת אחת אם אחד מהם עדיין פתוח. בחרו Habit off כדי להפסיק לעקוב אחריו בצ'אט הזה.
שמירת הרצה כהרגל
אחרי שהסוכן פותר משהו שתיתקלו בו שוב, בחרו Save as habit בהרצה שהסתיימה. Ingot מנסחת playbook ממה שקרה בפועל:
- steps מקריאות הכלים בהרצה (עד 10; קריאות קבצים רצופות מאוחדות לצעד אחד)
- keywords ו-globs מה-prompt ומהקבצים שנערכו
- doneCriteria מהבדיקות שהורצו, כמו tests, lint או build
עברו על הטיוטה, ערכו אותה ושמרו אותה בפרויקט או בהרגלים הגלובליים שלכם.
הגדרות
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
ingot.habits.playbooks.enabled | false | Habits (Settings › Features, ו-Use habits בעמוד Habits): הסוכן קורא את קובצי הסוגים שמתאימים למשימה ועוקב אחרי playbooks תואמים. כשהיא כבויה הקבצים נשארים, אבל הסוכן מתעלם מהם ו-Save as habit מוסתר |
ingot.habits.knowledge.autoSave | true | Agent adds what it learns to the type files: שורות HABIT: בתשובות נוספות ל-.ingot/habits/<type>.md. כשהיא כבויה הסוכן רק קורא את הקבצים |
ingot.habits.playbooks.autoSelect | true | בחירה אוטומטית של playbook תואם לפי ה-keywords, ה-globs ותבנית השגיאה שלו. כשהיא כבויה, playbook נמצא בשימוש רק כשאתם או הסוכן בוחרים בו |
ingot.habits.playbooks.disabled | [] | playbooks שכיביתם עבורכם בעמוד Habits, כמזהים כמו project:payments-bug; הקבצים במאגר לא משתנים |
ingot.habits.enabled | false | Learn habits: לזהות מה שאתם חוזרים עליו ולהציע להפוך אותו לחוק, פקודה או hook |
ingot.habits.threshold | 3 | כמה פעמים דפוס חוזר לפני ש-Ingot מציעה אותו |
מהטרמינל
ingot habits קורא וכותב את אותה תיקייה כמו עמוד Habits, כך שאפשר לנהל אותה בסקריפטים וב-CI. הוא אף פעם לא קורא למודל.
npx @ingotide/cli habits # the type files with entry counts, and the playbooks; --json
npx @ingotide/cli habits init # create the default type files that are missing
npx @ingotide/cli habits add "Always add a regression test before fixing a crash"
# Added to .ingot/habits/bug.md (bug: keyword "crash", keyword "regression"): …
npx @ingotide/cli habits add "Use the shared date helper" --type refactor
npx @ingotide/cli habits classify "Never log access tokens" # .ingot/habits/security.md (keyword "access token")
npx @ingotide/cli habits relevant "the checkout crashes on an empty cart" # the files and text the agent gets
npx @ingotide/cli habits read bug # print one type file
npx @ingotide/cli habits new-type i18n --keyword locale --keyword translation
npx @ingotide/cli habits types # descriptions, keywords and entry counts; --json
ל-playbooks:
npx @ingotide/cli habits show "Payments bug" # the steps, tools and done criteria
npx @ingotide/cli habits new "Release" --when "Shipping a release" \
--step "Bump the version" --step "Update the changelog" --step "Tag the commit" --keyword release
npx @ingotide/cli habits validate # exits 1 when a playbook file has errors; in CI
npx @ingotide/cli habits match "refund fails with CardDeclined" --file services/payments/refund.ts
npx @ingotide/cli habits prompt "Release" # what the agent gets while the playbook is active
npx @ingotide/cli habits remove "Release"
new מקבל גם --glob, --error, --tool, --done ו---notes, כותב ל-~/.ingot/habits עם --global, ולא דורס playbook בלי --force. match נותן ציון ל-playbooks כמו ה-IDE; הוסיפו --error-line לפלט טרמינל.
הרגלים נלמדים
בנפרד מהתיקייה, Ingot יכולה לזהות מה שאתם חוזרים עליו ולהציע לשמור אותו. הפעילו Learn habits ב-Settings › Tools › Habits (כבוי כברירת מחדל).
| היא מזהה | כרטיס לדוגמה |
|---|---|
| אותה הוראה ב-prompts שלכם | You often ask to use the shared Button component. |
| אותה פקודת טרמינל | You often run npm test. |
| עריכות של הסוכן שאתם דוחים שוב ושוב | You often reject edits that add console.log calls. |
אחרי שדפוס חוזר 3 פעמים (ההגדרה ingot.habits.threshold), מופיע בצ'אט כרטיס עם Make it a rule, Make it a command, Make it a hook (לפקודות) ו-Not now. השמירה כותבת קובץ רגיל שאפשר לערוך: חוק ב-.ingot/rules/, פקודת slash ב-.ingot/commands/, או hook מסוג stop ב-.ingot/hooks.json.
---
description: Learned habit: ask to use the shared Button component
alwaysApply: true
---
Use the shared Button component.
מה ש-Ingot למדה נשמר ב-.ingot/habits.json בפרויקט. Git מתעלם ממנו והוא אף פעם לא יוצא מהמחשב שלכם.
ההערה Saved to Habits
Beta בכל פעם שמשהו נשמר בהרגלים שלכם, מופיעה בצ'אט הפתוח הערה כסופה קטנה במקום חלון קופץ:
Saved to Habits| היא מופיעה כש | הפרט בהערה |
|---|---|
| הסוכן מוסיף רשומה לקובץ סוג | bug.md: Always add a regression test before fixing a crash |
| דפוס מגיע לסף | Learned: use the shared Button component |
| בוחרים Make it a rule, Make it a command או Make it a hook | use the shared Button component → .ingot/rules/use-the-shared-button-component.md |
| שומרים playbook | Payments bug → .ingot/habits/payments-bug.md |
לחיצה על ההערה פותחת אותו בעמוד Habits ב-Settings, שם הוא מודגש; קובץ סוג נפתח בעורך.
Undo בהערה מבטל את השמירה:
| Undo אחרי | התוצאה |
|---|---|
| רשומה בקובץ סוג | הרשומה יוצאת מהקובץ; שאר הקובץ נשאר כמו שהוא |
| דפוס שנלמד | הדפוס נשכח |
| Make it a rule או Make it a command | הקובץ נמחק (רק אם השמירה הזו יצרה אותו) וכרטיס ההצעה חוזר |
| Make it a hook | הפקודה יוצאת מ-stop ב-.ingot/hooks.json |
| שמירת playbook | קובץ ה-playbook נמחק |
ההערה מתחלפת ל-Removed from Habits. הערות מופיעות רק כשצ'אט פתוח; דפוסים נלמדים צריכים גם ש-Learn habits יהיה פעיל.