הקולקטיב — ידע ארגוני לצוותי AI

“We are the Borg. We will add your technological distinctiveness to our own.” — The Borg, Star Trek: The Next Generation

בחלק 1, הקמתי את ה-Squad הראשון שלי על פרויקט פנימי שנקרא provisioning wizard — עם צוות בסגנון Matrix: Morpheus, Trinity, Switch, Dozer (Star Trek כבר היה תפוס בריפו האישי שלי) — וצפיתי בהם טוחנים 52 משימות Planner במקביל. מדהים. ואז עשיתי מה שכל מהנדס נלהב עושה: הקמתי Squad על ריפו שני.

והצוות השני לא ידע שום דבר שהצוות הראשון למד.

Trinity ב-provisioning wizard כבר הבינה את פורמט ה-PR שלנו, את מוסכמות התיעוד שלנו, את דפוסי השילוב של MCP. הסוכנים ב-ConfigurationGeneration — אותו ארגון, אותו צוות — הסתכלו עליי עם פרצוף של סימן שאלה כשהזכרתי משהו מכל זה. כל Squad של ריפו היה אי בודד. דרון מנותק בלי Collective.

ואז נפל לי האסימון: הבעיה הקשה באמת ב-scaling של צוותי AI היא לא לגרום להם לעבוד בריפו אחד. האתגר האמיתי הוא לגרום להם לשתף ידע כמו שארגון הנדסי אמיתי עושה.

“נוסיף את הייחודיות הארגונית שלכם לשלנו.”

המבנה האמיתי של ארגוני תוכנה

רוב ארגוני ההנדסה האמיתיים לא חיים ב-monorepo. יש להם שכבות:

• ארגון — תקני ארכיטקטורה, מוסכמות קוד, מדיניות אבטחה. “כל השירותים משתמשים ב-managed identity.” “OpenAPI spec לכל API.”
• צוות — מומחיות תחומית שחוצה מספר ריפוים. “ה-.NET SDKs שלנו עוקבים אחרי הדפוס הזה.” “ADRs נמצאים ב-docs/decisions/.”
• ריפו — פרטי מימוש. קבצי ההקשר הספציפיים, ההחלטות המקומיות, המוזרויות של הריפו הספציפי.

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

כשמקימים Squad על כל ריפו, כל צוות מקבל את ה-AI squad שלו. אבל בלי הקשר משותף, ה-squads האלה הם דרונים בלי Collective.

הבעיה: ידע בהעתק-הדבק

הנה מה שבאמת קרה לי. בזבזתי שבועות על לבנות הקשר ב-ConfigurationGeneration — .NET SDK שמייצר deployment artifacts. יש לו .roo/context/ עם 8 קבצי הקשר שמכסים הכל — מארכיטקטורת ה-SDK ועד דפוסי ה-deployment. יש לו docs/decisions/ עם 70+ ADRs. יש לו docs/designs/ עם מסמכי עיצוב מפורטים. הסוכנים שעובדים בריפו הזה יודעים דברים. הם מכירים מוסכמות שמות, דפוסי טיפול בשגיאות, מבנה טסטים — הכל.

אז פתחתי את הריפו של provisioning wizard. ריפו אחר, אותו צוות. התחלתי סשן Squad חדש. לסוכנים שם היה .squad/skills/ משלהם עם 3 skills משותפים — docs-hygiene, fabric-rti-mcp, ו-pr-format. אבל הם לא ידעו שום דבר על הדפוסים הארגוניים שתיעדתי בקפידה ב-ConfigurationGeneration.

מצאתי את עצמי חוזר על עצמי שוב ושוב. כל ריפו חדש, כל Squad חדש — אותן מוסכמות מההתחלה. זה המקבילה ב-AI לתקני קוד בוויקי שאף אחד לא קורא.

ירושת Upstream

הפתרון של Squad הוא upstream inheritance — מערכת ידע היררכית שמשקפת איך ארגונים אמיתיים עובדים. לכל ריפו יש תיקיית .squad/ משלו, ומחברים ריפוים למקורות ידע משותפים דרך squad upstream add:

1
2
3
4

# In your repo:
squad init
squad upstream add https://github.com/my-org/platform-squad.git --name org
squad upstream add https://github.com/my-org/my-team-squad.git --name team

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

my-org/platform-squad.git             ← Org level (a regular repo with .squad/)
  .squad/
    decisions.md                       ← "Always use managed identity"
                                         "APIs follow OpenAPI spec"
    skills/                            ← Shared patterns: error handling,
                                         logging, API conventions
    routing.md                         ← Default routing rules

my-org/my-team-squad.git              ← Team level (another repo with .squad/)
  .squad/
    decisions.md                       ← "ADRs in docs/decisions/"
                                         ".NET SDK naming conventions"
    skills/                            ← Team-specific patterns

my-repo/.squad/                        ← Repo level
  decisions.md                         ← Repo-specific decisions
  agents/                              ← This repo's team

1
2
3
4
5

# Git repository — cloned and cached locally
squad upstream add https://github.com/my-org/platform-squad.git --name org

# Local directory — read live at session start
squad upstream add ../org-practices/.squad --name org-local

1
2
3
4

squad upstream list              # See what's connected
squad upstream remove org        # Disconnect an upstream
squad upstream sync              # Update all git-based upstreams
squad upstream sync org          # Update a specific upstream

1
2
3
4
5

# Export a skill from this repo
squad export --skill azure-keyvault-identity -o keyvault-skill.json

# Then add the exported skill to the team's upstream repo
# (commit it there so every downstream repo picks it up on next sync)

1
2
3
4
5
6
7
8

# .squad/skills/pr-format/skill.yml
name: pr-format
description: Standard PR format for team repos
confidence: high
steps:
  - title follows conventional commits format
  - description includes context, changes, and testing sections
  - checklist includes review items for security, docs, tests

1
2

squad init
squad upstream add https://github.com/my-org/my-team-squad.git --name team