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

> "התיקייה היא הבית של העבודה." וגם: "הסיומת .md לא יוצרת זיכרון קסום."

---

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

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

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

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

```markdown
# כותרת ראשית        ## כותרת משנה        ### תת-כותרת
פסקה רגילה. שורה ריקה = פסקה חדשה.
**מודגש**  *נטוי*  `קוד`  ~~מחוק~~
- תבליט              1. ממוספר
  - מקונן
- [ ] משימה פתוחה    - [x] משימה שבוצעה
[טקסט](https://...)   ![תמונה](image.png)
> ציטוט
---   (קו מפריד)
| עמודה | עמודה |
|------|------|
| א    | ב    |
```
תוספות שהסוכנים אוהבים: **frontmatter** בראש הקובץ (`---` / `name:` / `description:` / `---`) - זה איך SKILL.md וקבצי זיכרון מתייגים את עצמם. `[[קישור-פנימי]]` (Obsidian). `<!-- הערה -->` (קלוד מתעלם ממנה בקונטקסט).

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

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

| איפה | האופציות (מהפשוטה) |
|---|---|
| **מק** | Quick Look עם רווח בפיינדר - צריך תוסף: `brew install --cask qlmarkdown` (חינם). עורכים: **Obsidian** (חינם, ההמלצה), Typora (WYSIWYG, בתשלום), iA Writer (יפה, RTL טוב), Marked 2 (מציג ומתעדכן חי כשקלוד עורך - שילוב מנצח), VS Code / Cursor (Cmd+Shift+V לפריוויו). וגם: קלוד דסקטופ מציג md בפאנל, ואפליקציית ChatGPT גם |
| **ווינדוס** | Obsidian, Typora, VS Code, MarkText (חינם), Notepad++ עם תוסף, PowerToys (פריוויו בסייר) |
| **טלפון** | Obsidian mobile (סנכרון דרך iCloud/Obsidian Sync/git), iA Writer, אפליקציית GitHub (מציגה כל md בריפו) |
| **טרמינל** | `glow file.md` |
| **להמיר** | "תהפוך את זה ל-docx/PDF" (הסקילים הרשמיים) או `pandoc` |

---

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

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

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

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

**איך זה נראה אצלי (GenOS):**
```
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 פשוט הכי נעים לבני אדם.

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

| מאגר | גישת סוכן | טוב ל | חסרון |
|---|---|---|---|
| md מקומי (גיט) | כלי קבצים, ילידי | המוח הראשי, שני הסוכנים | הגיבוי עליכם |
| Obsidian | אותם קבצים | ממשק אנושי מעל המוח | אין |
| Notion | MCP / פלאגין | צוותים, טבלאות | לא מקומי, אין grep, צריך רשת |
| Google Drive/Docs | MCP לקריאה | מסמכים של לקוחות, שיתוף תוצרים | סעיף 7.5 |
| NotebookLM | MCP | שאלות מעוגנות על PDFים | לא מוח שכותבים אליו. "NotebookLM מעגן, קלוד מבצע" |

---

## 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 מעל, אם רוצים. שום מנוי.
- שלד תיקייה קבוע = הסוכן יודע איפה הכל, אתם יודעים איפה הכל, והסשן הבא מתחיל מהמקום הנכון.
- דרייב לקרוא. מקומי לעבוד.