Skip to content

guycoful/project-workspace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

project-workspace 📁

סקיל ל-Claude Code ו-Codex שמחלץ ומבודד פרויקטים מפוזרים לתיקיות עבודה (Workspaces) ייעודיות, מייצר שלד ניהול מלא (CLAUDE.md, SESSION_BRIEF.md ועוד), מנייד את הקבצים בבטחה ורושם טריגרים לטעינה אוטומטית.

כאשר אנו עובדים על מספר פרויקטים בתיקייה אחת, חלון ההקשר (Context Window) של סוכן ה-AI מתמלא ברעש והיסטוריה לא רלוונטית. הסקיל הזה מבודד כל פרויקט ל"בית" משלו, שומר על קוד נקי, ומאפשר לסוכן לפעול בצורה ממוקדת ומדויקת.


תהליך החילוץ והבידוד 🚀

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

flowchart TD
    A["🔍 שלב 1: אפיון<br/>איסוף פרטי פרויקט (Slug, שם, שותפים, סוג קשר)"] --> B
    B["📂 שלב 2: סריקה ומיפוי<br/>איתור אוטומטי של קבצי הפרויקט המפוזרים"] --> C
    C{"🛑 שלב 3: הצגה ואישור<br/>חוסם מוחלט! ממתינים לאישור מפורש מגיא"}
    C -- אישור --> D
    C -- ביטול --> End["עצירה"]
    D["⚙️ שלב 4: הרצת האוטומציה<br/>הסוכן מריץ את isolate_project.py"] --> E
    E["📄 שלב 5: יצירת השלד<br/>חולול 5 קבצי ניהול מותאמים אישית"] --> F
    F["📦 שלב 6: ניוד קבצים<br/>git mv לשמירה על ההיסטוריה"] --> G
    G["🧠 שלב 7: עדכון הזיכרון<br/>רישום טריגרים ב-CLAUDE הראשי וב-MEMORY.md"]
Loading

עקרונות הניהול והאבטחה 🔑

ארבעה עקרונות ברזל בלתי מתפשרים המגנים על שלמות הקבצים וההיסטוריה שלך:

עיקרון מה זה אומר בפועל
🛑 אישור חוסם (Blocker) אסור לנייד אף קובץ או לשנות קבצי מפתח לפני הצגת הטבלה וקבלת אישור מפורש ("כן" / "בצע").
📦 שמירה על היסטוריית Git אם התיקייה מנוהלת ב-Git, הניוד יבוצע אך ורק דרך git mv על מנת לשמור על היסטוריית הגרסאות.
🚫 ללא דריסת קבצים (No Overwrite) אם קובץ יעד כבר קיים בתיקיית הפרויקט, האוטומציה תדלג עליו ותעצור במקרה של סתירה.
📝 אפס ניחושים והמצאות פרטים שאינם ידועים נכתבים כ-[לברר] או [טרם נקבע]. לא ממציאים נתונים פיקטיביים.

שבעת מצבי העבודה ⚙️

הסקיל תומך בניהול מלא של מחזור חיי ה-Workspace:

flowchart LR
    A["🅰️ אבחון<br/>Slug, שם, Git, סוג קשר"] --> B["🅱️ מיפוי<br/>סריקה לפי keywords"]
    B --> C["©️ אישור<br/>טבלה מפורטת לאישור גיא"]
    C --> D["🆳 שלד ותבניות<br/>חולול קבצי ניהול מותאמים"]
    D --> E["🅴 ניוד בפועל<br/>git mv/mv בטוח"]
    E --> F["🅵 רישום ראשי<br/>הגדרת טריגרים אוטומטיים"]
    F --> G["🅶 זיכרון<br/>עדכון MEMORY.md ויומן"]
Loading

מבנה תיקיית סביבת העבודה החדשה 📂

לאחר הרצת הסקיל, תיווצר תיקיית הפרויקט במבנה הבא:

projects/<slug>/
├── CLAUDE.md          # חוקי הברזל והנחיות העבודה המקומיות לפרויקט
├── SESSION_BRIEF.md   # לוח המשימות היומי (Task board) ומצב נוכחי
├── AGENTS.md          # אנשי קשר ותפקידים (מותאם ל-Codex)
├── access.md          # מערכות מעורבות ופרטי גישה (ללא סודות חשיפים)
├── sessions-index.md  # אינדקס סיכומי פגישות
└── sessions/          # תיקייה ריקה לשמירת סיכומי פגישות עתידיים

למה קבצי הניהול קריטיים

כל קובץ שנפתח מותאם אישית לסוג ההתקשרות שנקבע בשלב האבחון:

  • שותפות (Partnership): עבודה משותפת, חלוקת רווחים (כמו מקפצה).
  • שכיר (Employee): שעות עבודה מוגדרות, הפרדת IP מוחלטת (כמו Valor).
  • לקוח סוכנות (Client): פרויקט הטמעה מוגדר, הצעת מחיר ב-Prospero.

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


מבנה הריפו 🛠️

project-workspace/
├── SKILL.md                      # הסקיל: 7 מצבים, חוקי ברזל (ל-Claude Code)
├── AGENTS.md                     # הסקיל: מותאם ל-Codex
├── README.md                     # קובץ זה: הדרכה מפורטת בעברית
├── scripts/
│   └── isolate_project.py        # סקריפט ה-Python המבצע את האוטומציה
└── assets/                       # קבצי התבניות ליצירת השלד
    ├── CLAUDE.template.md
    ├── SESSION_BRIEF.template.md
    ├── AGENTS.template.md
    ├── access.template.md
    └── sessions-index.template.md

הוראות הרצה ידניות 💻

האוטומציה מופעלת על ידי קובץ קונפיגורציה JSON זמני.

  1. יצירת קובץ scratch/workspace_config.json:
{
  "slug": "lumina",
  "name": "Lumina",
  "type": "לקוח סוכנות",
  "stakeholders": [
    {
      "name": "לירון",
      "role": "שותף טכנולוגי",
      "channel": "WhatsApp"
    }
  ],
  "keywords": ["lumina", "לירון", "fashion discovery"],
  "workspace_root": "C:\\Users\\guyco\\Desktop\\פרויקט",
  "execute_move": true,
  "files_to_move": [
    "outputs/lumina_brief.md",
    "scratch/test_liron.py"
  ]
}
  1. הרצת הסקריפט:
python "C:\Users\guyco\.claude\skills\project-workspace\scripts\isolate_project.py" "C:\Users\guyco\Desktop\פרויקט\scratch\workspace_config.json"

רישיון

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages