מוח שני: קבצי md, תיקיות, Obsidian, ומקומי מול דרייב

7.1 מה זה קובץ md (ולמה כל העולם האייג'נטי בנוי עליו)

בשפה פשוטה: קובץ טקסט רגיל. פותחים אותו ב-Notes או TextEdit ורואים טקסט קריא. רק שכמה סימני פיסוק אומרים "עיצוב": # כותרת, - תבליט, **מודגש**, [קישור](כתובת). מכונות (GitHub, Obsidian, קלוד, קודקס) מציגות אותו יפה; בני אדם קוראים אותו גם גולמי.

למה לא Word? Word טוב למסמך מוגמר. md טוב להוראות, תיעוד וזיכרון - כי אפשר לקרוא, להשוות גרסאות (diff), לערוך בשקיפות, ובעיקר: מודלים קוראים וכותבים אותו באופן טבעי. לכן CLAUDE.md, AGENTS.md, SKILL.md, README.md, MEMORY.md - כולם md.

צריך לדעת Markdown? מספיק כותרת, רשימה, קישור. הנה כל מה שצריך:

# כותרת ראשית        ## כותרת משנה        ### תת-כותרת
פסקה רגילה. שורה ריקה = פסקה חדשה.
**מודגש**  *נטוי*  `קוד`  ~~מחוק~~
- תבליט              1. ממוספר
  - מקונן
- [ ] משימה פתוחה    - [x] משימה שבוצעה
[טקסט](https://...)   ![תמונה](image.png)
> ציטוט
---   (קו מפריד)
| עמודה | עמודה |
|------|------|
| א    | ב    |

תוספות שהסוכנים אוהבים: frontmatter בראש הקובץ (--- / name: / description: / ---) - זה איך SKILL.md וקבצי זיכרון מתייגים את עצמם. [[קישור-פנימי]] (Obsidian). <!-- הערה --> (קלוד מתעלם ממנה בקונטקסט).

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

איך פותחים md יפה

7.2 מוח שני - איפה, איך, ולמה

למה: הצ'אט מת בסוף הסשן. הזיכרון האוטומטי הוא של הכלי (קלוד או קודקס) ושל המחשב הזה. מוח שני הוא ידע שהוא שלכם: ניטרלי לכלי, greppable, diffable, נייד, קריא לבני אדם. עובר איתכם גם כשמחליפים כלי, כשמחשב נשרף, כשמצטרפת שותפה.

מה: תיקייה מקומית של קבצי md. זהו. אין API, אין מסד נתונים, אין מנוי. קלוד וקודקס הם "סוכני קבצים" - תיקייה היא הזיכרון המשותף הכי זול שיש.

איפה: ריפו גיט על הדיסק (~/brain/, או אצלי Downloads/GenOS/), אופציונלית פתוח כ-vault של Obsidian, אופציונלית מגובה ל-GitHub פרטי / Time Machine / iCloud - כגיבוי, לא כתיקיית עבודה (סעיף 7.5).

GenOS/
├── CLAUDE.md          <- הוראות למי שנכנס לכאן
├── BRAIN.md           <- מפת ניתוב: לאיזה סקיל/סוכן/זיכרון הולכים לכל סוג משימה
├── A-agents/          <- הגדרות סוכנים
├── B-brain/           <- ידע: אנליטיקס, מחירים, דוגמאות, knowledge/ (מה שנקלט מקישורים)
├── C-core/            <- זהות: voice-dna.md, icp-profile.md (הכי חשוב. נקרא לפני כל תוכן)
├── M-memory/          <- learning-log.md, decisions.md, feedback.md
├── O-output/          <- תוצרים
└── T-tools/skills/    <- 50 סקילים

"תיקיות לפי תפקיד + מפת ניתוב." זו שיטה. יש אחרות:

• PARA (Projects / Areas / Resources / Archive) - פשוט, טוב למי שמתחיל.
• Zettelkasten-lite - פתקים אטומיים עם [[קישורים]] ודף אינדקס. סוכנים אוהבים כי קישורים = גרף שהמודל עוקב אחריו.
• LLM Wiki (הדפוס שקרפתי פרסם באפריל, ורוב תבניות ה-Obsidian+Claude ב-2026 מיישמות): raw/ (זורקים מקורות) ← הסוכן כותב דפים ב-wiki/ ומקשר ← index.md + log.md. סכמה אחת ב-CLAUDE.md מגדירה פורמט דף, שמות, קישורים, ושלוש פעולות: ingest / query / lint. שאלה שהתשובה עליה היא מושג חדש = דף חדש. זה בדיוק מה שהסקיל link-to-knowledge שלי עושה: קישור נכנס ← ידע מסודר ב-B-brain/knowledge/.

איך מתחילים (בלי לחפור)

1. תיקייה. git init.
2. CLAUDE.md + AGENTS.md (5 שורות: "זה המוח שלי. דפים ב-md. כל דף עם כותרת ותאריך. תקשר בין דפים. אל תמחק, תארכב.").
3. inbox/ לזרוק פנימה. notes/ למה שעוכל. index.md שקלוד מתחזק.
4. פעם בשבוע: "תעבור על inbox, תעכל, תעדכן index, תגיד לי מה סותר מה" (lint).

זהו. אחרי חודש יש לכם מוח.

7.3 למה אנשים אוהבים Obsidian (ולמה זה מתחבר מושלם לקלוד קוד)

• זה רק קבצים. ה-vault של Obsidian = תיקייה של md. אין נעילה, אין פורמט קנייני. cd vault && claude - אפס אינטגרציה.
• קישורים וגרף. [[דף]] יוצר קישור; יש תצוגת גרף שמראה מה הסוכן חיבר. backlinks. פתאום רואים את המוח.
• תוספים. אלפים. Dataview (שאילתות על הפתקים), Templater, Web Clipper (לקלוט דפי אינטרנט ל-inbox), Calendar.
• אופליין ובטלפון. אפליקציות מק/ווינדוס/iOS/אנדרואיד. סנכרון דרך iCloud/גיט/Obsidian Sync.
• חינם לשימוש אישי.

הזרימה הטיפוסית (2026): פתק יומי ← קלוד סורק inbox, מתייק, מקשר, מעדכן אינדקס. שבועי - lint (סתירות, יתומים). "journal:" בצ'אט ← קובץ מתוארך. שואלים שאלה, קלוד כותב את הסינתזה בחזרה ל-vault. אתם קוראים ב-Obsidian, קלוד כותב בטרמינל, אותם קבצים.

האם חייבים Obsidian? לא. VS Code, Cursor, או פיינדר עם QLMarkdown עושים את העבודה. Obsidian פשוט הכי נעים לבני אדם.

חלופות ואיפה הן מתאימות

7.4 מבנה תיקייה נוח לכל פרויקט (השלד שלי)

עובד לקוד ולא-קוד: סדנה, הצעה, מחקר, סרטון.

הפרויקט/
├── README.md              # מסך אחד: מה זה, למי, סטטוס, איך פותחים (בני אדם קודם)
├── AGENTS.md              # הבריף לסוכנים (ניטרלי): מטרה, כללים, מפת תיקיות, מותר/אסור
├── CLAUDE.md              # "@AGENTS.md" + הערות לקלוד (או symlink)
├── HANDOFF.md / KICKOFF.md# מצב חי: נעשה / הבא / חסמים / החלטות / עצירת אישור
├── TASKS.md               # [ ] / [x], שורה למשימה
├── AGENT_LOG.md           # append-only | תאריך | סוכן | פעולה | סטטוס |
├── docs/ או research/     # סיכומי פגישות, החלטות, מחקר (YYYY-MM-DD_נושא.md)
├── raw/ או sources/       # קלטים מקוריים. לא נוגעים. (read-only)
├── assets/                # לוגו, פונטים, רפרנסים
├── work/ או src/          # קבצי עבודה / קוד
├── output/                # מה שהלקוח רואה. לא עורכים מקורות פה
├── .claude/
│   ├── settings.json      # הרשאות והוקים לפרויקט
│   ├── skills/…/SKILL.md
│   ├── agents/…md
│   └── rules/*.md
├── .agents/skills/        # לקודקס (symlink ל-.claude/skills)
├── .mcp.json              # MCP של הפרויקט
├── .gitignore
└── .env.example           # שמות של סודות, לא ערכים

בערכת TAU השתמשתי במספור: 00_admin, 01_questions, 02_sources/raw, 03_methods, 04_data/{raw,processed}, 05_analysis, 06_writing, 07_outputs, 08_submission, 99_archive. "שמות התיקיות עונים מראש על השאלה איפה המקור ואיפה התוצר." "raw נשאר ללא שינוי, חסר מסומן, וכל טענה מקבלת מקור."

מוסכמות שמות

• קבצי שליטה באותיות גדולות (README, AGENTS, CLAUDE, HANDOFF, TASKS, AGENT_LOG) - ממוינים למעלה, ברור שהם "מטא".
• kebab-case לסקילים/סוכנים (ey-ai-proposal). עברית לתיקיות תוכן - כן, עובד מצוין (כל ה-Downloads שלי בעברית).
• תאריך ISO בהתחלה לכל מה שנצבר: 2026-08-17_kickoff.md. ממוין נכון לנצח.
• רעיון אחד לקובץ. AGENTS/CLAUDE מתחת ל-200 שורות. פרטים ← docs/ עם קישור.
• אף פעם לא קבצים משוחררים בשורש. לכל תוצר יש בית. (הכלל מספר אחת ב-CLAUDE.md שלי.)

git גם ללא-קוד: git init ביום הראשון. היסטוריה של כל עריכה של כל סוכן, git diff כביקורת, worktrees למקביליות, קודקס במצב נחמד. remote פרטי ב-GitHub = גיבוי + גישה מהטלפון.

.gitignore חובה: .env, *.key, secrets/, CLAUDE.local.md, .claude/settings.local.json, node_modules/, .DS_Store, וידאו כבד. אף פעם לא מפתחות API ב-CLAUDE.md/AGENTS.md/סקילים - שני הסוכנים בולעים אותם לזיכרון. במקום זה: קובץ registry שאומר "המפתח של X נמצא ב-Y" (אצלי api-keys-registry.md).

7.5 לעבוד מקומי או בגוגל דרייב?

התשובה הקצרה: מקומי + גיט, ודרייב לקרוא ולפרסם, לא לעבוד.

למה לא תיקיית דרייב מסונכרנת כתיקיית עבודה

• latency: הסוכן כותב, דרייב מעלה, מחשב אחר רואה אחר כך. שני סוכנים = "conflicted copy" כפולים.
• גיט נשבר בתוך תיקיות מסונכרנות (נעילות, קבצי desktop.ini, קבצים שמתרוקנים ל-stub ב"Optimize storage" - הסוכן עושה grep ומוצא כלום).
• היה גם באג היסטורי של איבוד קבצים בדרייב דסקטופ. לא צריך יותר מזה.

מה כן

• העבודה בתיקייה מקומית עם git init, גיבוי ל-GitHub פרטי (או Time Machine).
• Drive MCP / קונקטור כדי לקרוא מסמכים שלקוחות משתפים ("תקרא את הסינופסיס בדרייב ותבנה תיקיית פרויקט" - עשיתי אתמול), ולפרסם תוצרים גמורים (PDF לתיקיית הלקוח).
• אם צוות אנושי חייב לחיות בדרייב - עותק העבודה של הסוכן נשאר מקומי, ומסנכרנים בכוונה (העתקה או rclone), אף פעם לא שני סוכנים כותבים לאותה תיקיית דרייב במקביל.
• אותו היגיון ל-Dropbox / OneDrive / iCloud Drive.

חריג סביר: תיקיית סקרין-שוטים או מדיה שרק נקראת - בסדר גם מדרייב.

7.6 מה זה נותן לי?

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