Tutorial 1 Orientation he

מדריך 1 · התמצאות

מטרה: להריץ את הפרויקט, להכיר את סוכן ה-AI שלכם ולהריץ את מחסום הבדיקות פעם אחת — כך שכל מה שאחרי זה יהיה זיכרון שרירי.

← חזרה אל בית · הבא: מדריך 2 איך הקוד עובד

---

1. למה אפליקציית בדיחה?

ללמוד לעבוד עם סוכן קידוד קל ביותר כשהקוד קטן, אמיתי ובעל סיכון נמוך. LockedIn CLI הוא כל השלושה:

• קטן: קובץ ליבה אחד, נקודת כניסה אחת, חבילת בדיקות אחת, אפס תלויות.
• אמיתי: הוא מותקן כפקודה גלובלית lockedin ומתנהג כמו CLI אמיתי של AI.
• סיכון נמוך: זו סאטירה. אם הסוכן שלכם הופך את ההשוויצים-הצנועים לצנועים ב-20% יותר, אף אחד לא מקבל התראה.

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

2. השיגו את הקוד

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

בדקו את גרסת ה-Node שלכם (צריך 18+):

node --version

אין מה להתקין — אין npm install של תלויות, כי אין כאלה. זה מכוון: פחות חלקים נעים, יותר למידה.

3. הריצו אותו

נסו את הדבר האמיתי:

node bin/lockedin.js            # מסך הפתיחה + הבאנר
node bin/lockedin.js post       # פוסט "מנהיגות מחשבתית" שנוצר
node bin/lockedin.js aura       # סריקת ההילה המקצועית שלך
node bin/lockedin.js            # (ללא ארגומנטים) כניסה לסשן הצ'אט

הקלידו /help בתוך הסשן, חטטו סביב, ואז /exit. כל מה שאתם רואים נוצר מקומית ממאגרי מילים — ללא רשת, ללא חשבונות. רשימת פקודות מלאה: מדריך פקודות.

4. הריצו את מחסום הבדיקות

זו הפקודה החשובה ביותר בכל המדריך:

npm test

אתם אמורים לראות קיר של סימני ✓ ירוקים שמסתיים במשהו כמו pass 318. החבילה הזו היא רשת הביטחון שלכם. מכאן והלאה, תהליך העבודה הוא תמיד:

שנו משהו → npm test → שגרו רק אם זה ירוק.

5. הכירו את הסוכן שלכם

פתחו את סוכן הקידוד שלכם בתיקיית הפרויקט כדי שיוכל לראות את הקבצים. עם GitHub Copilot CLI, זה:

copilot

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

"תן לי סיור בן שתי פסקאות במאגר הזה: לְמה משמש כל קובץ ותיקייה ברמה העליונה, ואיך אני מריץ את האפליקציה ואת הבדיקות. אל תשנה כלום."

קראו את התשובה שלו מול מה שראיתם בשלבים 3–4. להתרגל לבקש מהסוכן להסביר לפני שהוא עורך הוא הרגל מרכזי — נישען עליו רבות.

---

✅ נסו עם הסוכן שלכם

1. שאלו את הסוכן: "מה מדפיס node bin/lockedin.js reflect 'הקפה שלי היה קר', ואיזה קובץ קובע את הפלט הזה?" אשרו את תשובתו על ידי הרצת הפקודה בעצמכם.
2. בקשו ממנו להריץ את חבילת הבדיקות ולדווח על התוצאה: "הרץ npm test ואמור לי כמה בדיקות עוברות."

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

הבא: מדריך 2 איך הקוד עובד