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

ידע

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

‎/knowledge בצ׳אט של הסוכן: רשומות לפי סוג עם הגרסה ורמת הביטחון, ורשומה אחת שפג תוקפה‎/knowledge בצ׳אט של הסוכן: רשומות לפי סוג עם הגרסה ורמת הביטחון, ורשומה אחת שפג תוקפה
‎/knowledge בצ׳אט של הסוכן: רשומות לפי סוג עם הגרסה ורמת הביטחון, ורשומה אחת שפג תוקפה

איפה זה נשמר

ב-.ingot/knowledge/ יש תיקייה לכל סוג, וכל רשומה היא קובץ markdown אחד:

סוגבשביל
projectמה הפרויקט, מי משתמש בו, איך בונים ומריצים אותו
architectureשכבות, גבולות ואיפה כל דבר נמצא
decisionהחלטה שהתקבלה, ולמה (תיקייה decisions/)
dependencyספרייה או שירות, הגרסה שלהם והמוזרויות שלהם (תיקייה dependencies/)
historyמה ניסינו ומה קרה: "ניסינו X, זה שבר את הארכיטקטורה, וזו הסיבה"

החלטות ותלויות נשמרות בתיקיות ברבים decisions/ ו-dependencies/. רשומות בתיקיות הישנות decision/ ו-dependency/ עדיין נקראות, ומתעדכנות במקומן.

---
kind: history
title: Tried a global store for the cart
source: PR 812
confidence: high
version: 2
created: 2026-11-19
updated: 2026-11-20
expires: never
paths: src/cart
---
It broke server rendering because state leaked between requests. Use one store per request.

עשו commit לתיקייה כדי לשתף אותה עם הצוות.

מקור, ביטחון, גרסה ותפוגה

  • מקור: מאיפה העובדה הגיעה, למשל מסמך, pull request, .ingot/decisions.md, צ׳אט או you.
  • ביטחון: low, medium או high.
  • גרסה: שמירה של רשומה עם אותו סוג ואותה כותרת מעדכנת אותה. הגרסה עולה, והגרסה הקודמת נשמרת ב-.ingot/knowledge/.history/<id>/v<n>.md.
  • תפוגה: רשומות dependency פגות אחרי 180 יום, ורשומות project ו-architecture אחרי שנה. החלטות והיסטוריה לא פגות אף פעם. רשומה שפג תוקפה לא נשלחת לסוכנים עד שמחדשים אותה עם /knowledge renew <שם> בצ׳אט של הסוכן.

אף פעם לא סוד

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

הסוכנים משתמשים בזה

  • מנוע ההקשר: בכל תור, עד 6 רשומות מגיעות לסוכן עם הסוג, המקור, רמת הביטחון והגרסה שלהן. אלה הרשומות על הקבצים שבעבודה או על המילים בהודעה שלכם, ואף פעם לא רשומות שפג תוקפן. הן מופיעות גם בתור Knowledge ב-Task context מתחת להודעה.
  • הסוכנים מוסיפים מה שהם אימתו: שורה בתשובה כמו KNOWLEDGE(history): Tried floats for totals | Floats broke rounding, so totals stay in cents נשמרת עם הצ׳אט בתור המקור. הצ׳אט מציג אז Saved to Knowledge עם Undo ו-Open. Undo מוחק רשומה חדשה, או מחזיר את הגרסה הקודמת של רשומה שעודכנה. אם השורה נראית כמו סוד, הצ׳אט מציג Not saved to Knowledge: it looks like a secret.

ניהול

/knowledge בצ׳אט של הסוכן מציג את כל הרשומות לפי סוג, עם הגרסה ורמת הביטחון, ומסמן רשומות שפג תוקפן. /knowledge <מילים> מחפש בכותרת, בטקסט, בתגיות, בנתיבים ובמקור. לחיצה על רשומה פותחת את הקובץ שלה. /remember decision: <כותרת> | <טקסט> (או project:, dependency:, history:) מוסיף רשומה, /forget <שם> מוחק רשומה עם Undo, ו-/knowledge renew <שם> מחדש רשומה שפג תוקפה. /knowledge import מוסיף את ההחלטות הנעולות ואת הלקחים מההקשר המשותף כרשומות; ייבוא חוזר מעדכן אותן. ב-Find Action יש Show Knowledge (מציג את התיקייה), Add Knowledge Entry… ו-Import Decisions and Learnings into Knowledge. ב-הגדרות › Knowledge נשארו רק המתג ו-Open .ingot Folder.

כיבוי

הגדרהברירת מחדלאיפה
ingot.knowledge.enabledפועלהגדרות › Knowledge, הגדרות › Features › Knowledge

כבוי: הסוכנים לא מקבלים ידע ולא שומרים ידע. הקבצים נשארים.

ראו גם מנוע ההקשר, יומן ההחלטות, הקשר משותף והרגלים.