פריסת הפרויקט
פריסת הפרויקט (Project layout) שומרת את הקבצים ש-Ingot כותב תחת .ingot/ בזמן העבודה מחוץ ל-git status, ומספרת לסוכנים איפה הפרויקט שלכם שומר את הבדיקות, כך שבדיקה חדשה נוחתת ליד אלה שכבר קיימות.
הפיצ׳ר פעיל כברירת מחדל. מפעילים ומכבים אותו ב-Settings › Features › Project layout, ברשימה Customize… של ההגדרה הראשונית (Help › Set Up Ingot…) או מהשורה שלו ב-Ingot Health.
קובצי זמן הריצה נשארים מחוץ ל-git
רוב התיקייה .ingot/ היא הגדרות ששומרים ב-git: כללים, פקודות, skills, סוכנים, הרגלים, הקשר משותף, mcp.json, hooks.json, policy.json, frozen.json ועוד (ראו סכמות .ingot). חלק ממנה הוא מצב זמן ריצה ששייך רק למחשב שלכם:
| תבנית | מה זה |
|---|---|
artifacts/ | תוכניות, הדרכות וצילומי מסך מהרצות של סוכנים |
index/ | אינדקס הקוד המקומי |
history/ | תמונות מצב של ההיסטוריה המקומית |
.state/ | פגיעות של כללים ומצב הכללים הנלמדים |
handoffs/ | תקצירים להתחלה בהקשר נקי |
arena/pending/ | קרבות Arena שמחכים להצבעה |
cache/, tmp/ | מטמון וקבצים זמניים |
runs/ | מצב ההרצות של הסוכנים |
logs/, *.log | יומנים |
habits.json, habits-learned.json | הרגלים והעדפות שנלמדו במחשב הזה |
Ingot שומר את התבניות האלה בבלוק מנוהל שמתחיל ב-# >>> Ingot runtime files ונגמר ב-# <<< Ingot runtime files. איפה הבלוק נכתב תלוי בפרויקט:
- הפרויקט שומר ב-git הגדרות
.ingot(כללים, skills, פקודות וכו׳): הבלוק נכתב ב-.ingot/.gitignore. עשו commit לקובץ הזה יחד עם שאר ההגדרות, כדי שגם חברי הצוות יקבלו את אותן התעלמויות. - אחרת: הבלוק נכתב ב-
.git/info/exclude. הקובץ הזה מקומי לעותק שלכם ואף פעם לא נכנס ל-commit, כך שלא מופיע קובץ חדש בפרויקט. עד שהפרויקט שומר ב-git הגדרות.ingot, גםcontext/,memory/ו-anti-habits.mdנשארים מקומיים, כך שהרצת סוכן אף פעם לא מוסיפה אותם ל-git status.
Ingot בודק את הבלוק כשתיקייה נפתחת ולפני כל הרצת סוכן, ומוסיף כל תבנית שחסרה. שורות שכתבתם מחוץ לבלוק לא נוגעים בהן. ב-worktree מקושר, הבלוק נכתב ב-.git/info/exclude של העותק הראשי, שמשותף לכל ה-worktrees.
הסוכנים עוקבים אחרי מבנה הבדיקות שלכם
Ingot קורא איך הפרויקט בודק את הקוד שלו:
- מסגרת הבדיקות והפקודה שמריצה אותן
- איפה הבדיקות נמצאות: קובץ בדיקות אחד לחבילה, ליד קוד המקור, בתיקיות
__tests__או בתיקייהtest,testsאוspec - איך קובצי הבדיקה נקראים, למשל
cart.test.tsאוtest_cart.py
לפני שסוכן מוסיף או משנה בדיקות, הוא מקבל את המבנה הזה בהנחיות שלו. קובץ בדיקה חדש שלא מתאים למבנה לא נשמר, והסוכן מקבל הודעה לאן הוא שייך, כך שהוא כותב אותו שם. בדיקות קצה לקצה (Playwright ו-Cypress, בתיקיות e2e, cypress או playwright, או בשמות *.e2e.* או *.cy.*) שומרות על התיקייה והשמות שלהן ולא נבדקות.
כשהסוכן אומר ש״הבדיקות עוברות״, Ingot מריץ את הבדיקות לפני שההרצה מסתיימת, כך שהטענה נשענת על הרצה אמיתית. ראו סיום משימות.
כל מבנה פרויקט
מבנה הבדיקות ומפת הפרויקט עובדים בלי תיקיית src. Ingot קורא את רשימת הקבצים מ-git (כל קובצי ה-.gitignore, גם בתת-תיקייה של ריפו גדול יותר, וגם תיקייה שהיא ריפו git משלה, כמו portal/ עם .git משלה, שנרשמת לפי ה-git שלה ומופיעה במפת הפרויקט), או סורק את התיקייה תוך כיבוד כל .gitignore כשאין git; הוא מדלג על תיקיות תלויות (node_modules, Pods של CocoaPods, .gradle) גם כשהן שמורות בריפו, וקורא את lib/ כקוד מקור (מדלג על lib/ רק כשהיא ליד src/ שממנה היא מקומפלת). הוא מזהה:
| פרויקט | מה Ingot מוצא |
|---|---|
| React Native (Expo או bare) | app/, components/, App.tsx בשורש; jest מתוך package.json |
| Next.js עם app router | app/layout.tsx ו-app/page.tsx כנקודות כניסה, בדיקות ב-lib/ |
| Monorepo | חבילות מ-workspaces של npm, pnpm או yarn, Lerna, Turborepo או Nx; ה-framework של הבדיקות מהחבילות כשהשורש לא מציין אחד |
| Python | תיקיית החבילה בשורש, tests/ עם test_<name>.py, python -m pytest |
| Go | go test ./..., <name>_test.go ליד הקוד |
| Gradle או Maven | src/test/java/… שמשקף את src/main/java/…, ./gradlew test או mvn test |
| Rust | cargo test, מודולי #[cfg(test)] בקובץ או tests/<name>.rs |
| ריפו שטוח | קוד בשורש, test.js בשורש |
בפרויקט גדול המפה קוראת דגימה מאוזנת מכל תיקייה, הקבצים הרדודים קודם, כך שתיקיית ios/ או android/ גדולה אף פעם לא מסתירה את הקוד של האפליקציה. Help › Ingot Health… › Project setup מראה מה זוהה.
איפה רואים את זה
Ingot Health. השורה Project layout, מיד אחרי Git, אומרת אם קובצי זמן הריצה מוחרגים מ-git ואיזה מבנה בדיקות הסוכנים מקבלים, למשל "Runtime files stay out of git. Tests: …".
| שורה | משמעות | תיקון |
|---|---|---|
| OK | קובצי זמן הריצה מוחרגים, והסוכנים עוקבים אחרי המבנה שמוצג | |
| אזהרה | חלק מתבניות זמן הריצה של .ingot עדיין לא מוחרגות, והשורה מציינת את הקובץ | Fix ignores כותב את התבניות החסרות |
| Off | הפיצ׳ר כבוי | Turn on |
| Off | אין תיקייה פתוחה, או שהתיקייה אינה מאגר git, ולכן אין מה להחריג |
לפריסת הפרויקט אין כפתור בשורת המצב; בעיה מופיעה ב-Ingot Health כמו כל בדיקה אחרת.
חלונית Project Layout. Project Layout: Show Tests and Ignores ב-Find Action (⌥⌘T, Ctrl+Alt+T) פותח חלונית עם מבנה הבדיקות, קובצי הבדיקה הקיימים בפרויקט, תיבה Where does the test for a file go? (כותבים src/cart.ts והיא מציגה את הנתיב של הבדיקה) ומצב ההחרגות עם Fix ignores. כשהחלונית בפוקוס, ⌥⌘0 (Ctrl+Alt+0) מפעיל או מכבה את הפיצ׳ר, ו-⌥⌘D (Ctrl+Alt+D) מתקן את ההחרגות.
צ׳אט. כשהפיצ׳ר כבוי, הודעה על בדיקות, specs או git status מציגה כרטיס הצעה קטן, Enable Project layout, עם × לסגירה.
הגדרות
שלושתן נמצאות ב-Settings › Tools › Project layout, וכמו כל הגדרה הן מפתחות בקובצי ההגדרות.
| מפתח | מה הוא עושה | ברירת מחדל |
|---|---|---|
ingot.projectLayout.enabled | Project layout: הפיצ׳ר כולו, ההחרגות ומבנה הבדיקות לסוכנים | true |
ingot.projectLayout.ignoreRuntimeFiles | Keep .ingot runtime files out of git: כתיבה ובדיקה של הבלוק המנוהל | true |
ingot.projectLayout.followTestLayout | Agents follow this project's test layout: הסוכנים מקבלים את המבנה, וקובצי בדיקה חדשים מחוץ לו לא נשמרים | true |
למשל, כדי להשאיר את ההחרגות אבל לתת לסוכנים לשים בדיקות בכל מקום בפרויקט אחד, הוסיפו את זה ל-<project>/.ingot/settings.json:
{
"ingot.projectLayout.followTestLayout": false
}
קיצורי מקלדת
| פעולה | macOS | Windows / Linux |
|---|---|---|
| Project Layout: Show Tests and Ignores | ⌥⌘T | Ctrl+Alt+T |
| Project Layout: Turn On or Off (כשהחלונית בפוקוס) | ⌥⌘0 | Ctrl+Alt+0 |
| Project Layout: Keep .ingot Runtime Files out of Git (כשהחלונית בפוקוס) | ⌥⌘D | Ctrl+Alt+D |
דסקטופ ודפדפן
פריסת הפרויקט עובדת אותו דבר באפליקציית הדסקטופ ובדפדפן.
שאלות נפוצות
למה .ingot/.gitignore השתנה? הפרויקט שלכם שומר ב-git הגדרות .ingot, ולכן Ingot מחזיק שם את תבניות זמן הריצה שלו בבלוק מנוהל. עשו commit לשינוי; Ingot עורך רק את השורות שבין שני הסימונים שלו.
אני לא רוצה ש-Ingot ייגע בקובצי ההחרגה שלי. כבו את Keep .ingot runtime files out of git (ingot.projectLayout.ignoreRuntimeFiles). הסוכנים עדיין עוקבים אחרי מבנה הבדיקות.
קובץ הבדיקה של הסוכן לא נשמר. הוא לא התאים למבנה הבדיקות של הפרויקט. הסוכן מקבל הודעה לאן הקובץ שייך וכותב אותו שם. פתחו את חלונית Project Layout כדי לראות את המבנה ש-Ingot זיהה, או כבו את Agents follow this project's test layout אם הפרויקט משלב כמה מבנים בכוונה.
זה אותו דבר כמו .ingot/ignore? לא. .ingot/ignore מסתיר קבצים מהסוכנים; פריסת הפרויקט שומרת את הקבצים של Ingot עצמו מחוץ ל-git. ראו קובצי התעלמות.