תיעוד 11

כללי פרויקט

כללי פרויקט הם קבצי Markdown ש־Grok טוען להקשר בכל הפעלה בעץ תיקיות. שים מוסכמות קידוד, פקודות בנייה ובדיקה, והערות ארכיטקטורה בקובץ AGENTS.md בשורש המאגר, ו־Grok יעקוב אחריהם בלי שתצטרך לחזור עליהם בכל הפעלה.

#גילוי

Grok טוען כללים בסדר הזה, וקבצים עמוקים יותר מקבלים עדיפות כשיש התנגשות:

כללים גלובליים ב־~/.grok/
כל תיקייה משורש המאגר עד תיקיית העבודה (או רק תיקיית העבודה מחוץ למאגר git)

בכל תיקייה Grok קורא כל אחד מהקבצים AGENTS.md, Agents.md, AGENT.md, CLAUDE.md, Claude.md ו־CLAUDE.local.md, וגם כל קובץ *.md בתיקייה .grok/rules/ (גם .claude/rules/ ו־.cursor/rules/ נקראות לצורך תאימות). קבצים ש־.gitignore מתעלם מהם מדולגים, וכך דריסות אישיות כמו CLAUDE.local.md נשארות מחוץ להקשר המשותף.

קובץ AGENTS.md מקונן חל על תת העץ שלו, כך שמאגר מונוריפו יכול לשאת מוסכמות שונות לכל חבילה:

my-monorepo/
  AGENTS.md                
# repo-wide rules
  packages/
    frontend/AGENTS.md     
# "Use React. Prefer CSS modules."
    backend/AGENTS.md      
# "Use Express. Follow REST conventions."

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

#כללי הפעלה

כדי להוסיף כללים להרצה אחת בלי לערוך קבצים, השתמש ב־--rules (Grok מצרף את הטקסט לפרומפט המערכת), או ב־--system-prompt-override כדי להחליף את פרומפט המערכת לגמרי:

grok --rules "Always use TypeScript. Prefer functional components."

#אימות

grok inspect

הפקודה מציגה כל קובץ כללים ש־Grok מצא, עם הנתיב שלו ומספר הטוקנים המשוער.