זרימת עבודה של סוכנים ארוכת שנים

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

מטרות

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

איפה לשמור על המדינה

• השתמש ב-docs/agent-runs/<slug>/ כאשר בני אדם, בוטים של ביקורות או רשתות כלים מרובות זקוקים לאותו מצב משימה.
• השתמש בספרייה מקומית לכלי כגון .codex/runs/<slug>/ רק כאשר מצב המשימה הוא מקומי בכוונה לתחנת עבודה אחת או לשרשרת כלים אחת.
• אל תסתיר מצב משותף של ריבוי מפגשים בקובץ שריטה פרטי אם תורם או סוכן אחר יזדקק לו מאוחר יותר.

קבצים נדרשים

צור קבצים אלה בתחילת המשימה הארוכה:

• feature-list.json
• progress.md

השתמש בתבניות ב-docs/agent-playbooks/templates/feature-list.template.json ו-docs/agent-playbooks/templates/progress.template.md.

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

רשימת רשימת התחלת הפעלה

1. הפעל את pwd.
2. קרא את progress.md.
3. קרא את feature-list.json.
4. הפעל את git log --oneline -20.
5. הפעל את ./scripts/agent-init.sh --smoke.
6. בחר בדיוק פריט אחד בעדיפות הגבוהה ביותר שהוא עדיין pending, in_progress או blocked.

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

חוקי הפגישה

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

רשימת סיום הפעלה

1. הוסף ערך התקדמות קצר ל-progress.md.
2. עדכן את הפריט שנגע בו ב-feature-list.json.
3. רשום את הפקודות המדויקות שפועלות לאימות.
4. חוסמי לכידת, מעקבים והפריט הבא הטוב ביותר לחידוש.

צורת כניסת התקדמות מומלצת

השתמש במבנה קצר כמו:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build:verify`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.