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

הרגלים

הרגלים הם תיקייה, .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 ב-Settings של Ingot: ‏Knowledge by type עם התיקייה .ingot/habits/, ‏bug.md עם 2 רשומות, שאר קובצי הסוגים ו-+ Add typeעמוד Habits ב-Settings של Ingot: ‏Knowledge by type עם התיקייה .ingot/habits/, ‏bug.md עם 2 רשומות, שאר קובצי הסוגים ו-+ Add type
עמוד Habits ב-Settings של Ingot: ‏Knowledge by type עם התיקייה .ingot/habits/, ‏bug.md עם 2 רשומות, שאר קובצי הסוגים ו-+ Add type

הפעלה

את 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 נשאר פעיל, קובץ סוג שמחקתם נשאר מחוק.

הכפתור Habits בשורת המצב של Ingot, פעילהכפתור Habits בשורת המצב של Ingot, פעיל
הכפתור Habits בשורת המצב של Ingot, פעיל
ההגדרות של Ingot, עמוד Features עם המתג של Habitsההגדרות של Ingot, עמוד Features עם המתג של Habits
ההגדרות של Ingot, עמוד Features עם המתג של Habits
עמוד Habits של Ingot כש-Use habits כבוי: הערה אומרת שהסוכן לא קורא ולא כותב הרגליםעמוד Habits של Ingot כש-Use habits כבוי: הערה אומרת שהסוכן לא קורא ולא כותב הרגלים
עמוד Habits של Ingot כש-Use habits כבוי: הערה אומרת שהסוכן לא קורא ולא כותב הרגלים

קובצי הסוגים

קובץמה נכנס אליו
bug.mdתיקוני באגים: משהו קורס, זורק שגיאה או נותן תוצאה שגויה
defect.mdפגמים מול האפיון: זה עובד, אבל לא כמו שכתוב בטיקט או בתנאי הקבלה
design.mdUI ו-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 סוגרים את העורך בלי לשמור.

‏bug.md פתוח בעמוד Habits של Ingot: העורך של .ingot/habits/bug.md עם ה-frontmatter ו-2 רשומות‏bug.md פתוח בעמוד Habits של Ingot: העורך של .ingot/habits/bug.md עם ה-frontmatter ו-2 רשומות
‏bug.md פתוח בעמוד Habits של Ingot: העורך של .ingot/habits/bug.md עם ה-frontmatter ו-2 רשומות

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

‏Add type בעמוד Habits של Ingot: ‏migrations מוקלד בשדה השם ליד .md, עם Cancel ו-Add‏Add type בעמוד Habits של Ingot: ‏migrations מוקלד בשדה השם ליד .md, עם Cancel ו-Add
‏Add type בעמוד Habits של Ingot: ‏migrations מוקלד בשדה השם ליד .md, עם Cancel ו-Add

שמירת ידע מה-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.

כרטיס ההצעה של Habits מעל תיבת הצ'אט של Ingot: ‏Keep this in .ingot/habits/bug.md so the agent follows it in every future run, עם Enable Habits וכפתור סגירהכרטיס ההצעה של Habits מעל תיבת הצ'אט של Ingot: ‏Keep this in .ingot/habits/bug.md so the agent follows it in every future run, עם Enable Habits וכפתור סגירה
כרטיס ההצעה של Habits מעל תיבת הצ'אט של Ingot: ‏Keep this in .ingot/habits/bug.md so the agent follows it in every future run, עם Enable Habits וכפתור סגירה

Playbooks לתרחישים

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

עמוד Habits של Ingot: ‏Use habits פעיל, קובצי הסוגים ו-playbook בשם Release תחת Scenario playbooksעמוד Habits של Ingot: ‏Use habits פעיל, קובצי הסוגים ו-playbook בשם Release תחת Scenario playbooks
עמוד Habits של Ingot: ‏Use habits פעיל, קובצי הסוגים ו-playbook בשם Release תחת Scenario playbooks

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

כרטיס ההצעה של Habits מעל תיבת הצ'אט של Ingot: ‏Save steps like these as a habit, עם Enable Habits וכפתור סגירהכרטיס ההצעה של Habits מעל תיבת הצ'אט של Ingot: ‏Save steps like these as a habit, עם Enable Habits וכפתור סגירה
כרטיס ההצעה של Habits מעל תיבת הצ'אט של Ingot: ‏Save steps like these as a habit, עם Enable Habits וכפתור סגירה
‏playbook שנוסח מ-prompt בצ'אט בעמוד Habits של Ingot: השם Release, ‏when, והצעדים bump the version, ‏update the changelog ו-tag the commit‏playbook שנוסח מ-prompt בצ'אט בעמוד Habits של Ingot: השם Release, ‏when, והצעדים bump the version, ‏update the changelog ו-tag the commit
‏playbook שנוסח מ-prompt בצ'אט בעמוד Habits של Ingot: השם Release, ‏when, והצעדים bump the version, ‏update the changelog ו-tag the commit

קובץ 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 מופיעה ב-prompt2
קובץ בהקשר תואם ל-globs1

נבחר ה-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.enabledfalseHabits ‏(Settings › Features, ו-Use habits בעמוד Habits): הסוכן קורא את קובצי הסוגים שמתאימים למשימה ועוקב אחרי playbooks תואמים. כשהיא כבויה הקבצים נשארים, אבל הסוכן מתעלם מהם ו-Save as habit מוסתר
ingot.habits.knowledge.autoSavetrueAgent adds what it learns to the type files: שורות HABIT: בתשובות נוספות ל-.ingot/habits/<type>.md. כשהיא כבויה הסוכן רק קורא את הקבצים
ingot.habits.playbooks.autoSelecttrueבחירה אוטומטית של playbook תואם לפי ה-keywords, ה-globs ותבנית השגיאה שלו. כשהיא כבויה, playbook נמצא בשימוש רק כשאתם או הסוכן בוחרים בו
ingot.habits.playbooks.disabled[]‏playbooks שכיביתם עבורכם בעמוד Habits, כמזהים כמו project:payments-bug; הקבצים במאגר לא משתנים
ingot.habits.enabledfalseLearn habits: לזהות מה שאתם חוזרים עליו ולהציע להפוך אותו לחוק, פקודה או hook
ingot.habits.threshold3כמה פעמים דפוס חוזר לפני ש-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 hookuse the shared Button component → .ingot/rules/use-the-shared-button-component.md
שומרים playbookPayments 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 יהיה פעיל.