תוכנית האתר

PLAN.md נכתב ברגע שהבנייה הראשונה של הפרויקט מסתיימת, והוא נועד לתאר תמיד את האתר כפי שהוא עכשיו — לא יומן של כל מה שקרה לו (לזה משמשות לשונית הגרסאות והיומן). מסך תוכנית האתר מפרק את ה-Markdown הזה לממשק אמיתי: טבלה לעמודים, רשימה למודולים, רשימת סימון לשאלות פתוחות, וטקסט רגיל לעובדות עסקיות, מותג והחלטות.

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

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

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

מתחת לכותרת, שורה אחת מציינת מתי התוכנית עודכנה לאחרונה: "התוכנית עודכנה ב-2 באוקטובר, 15:04". הזמן הזה מגיע מהפעם האחרונה שבה aiKit מדדה את הקבצים האמיתיים של האתר, וזה קורה אחרי כל שינוי (עריכת צ'אט, נעיצה, הוספה מהקיט, שחזור, עריכה ידנית של התוכנית, או פרסום מכלי AI אחר).

בראש הדף, אחרי שיש תוכנית: סרגל התקדמות כללי באחוזים, ושלוש כרטיסיות מתחתיו: דפים שנבנו (מתוך הדפים המתוכננים), מודולים שנבנו (מתוך המודולים שנבחרו), ושאלות שנענו (מתוך השאלות הפתוחות בתוכנית). כל כרטיסייה היא כפתור שגולל לסעיף שהיא סופרת. שום דבר מזה אינו מבוסס על הדיווח של טקסט התוכנית: דף נחשב כבנוי רק כש-aiKit מצא אותו בקבצים האמיתיים של האתר; מודול נחשב כבנוי רק לפי דוח הבנייה המאומת או מודול שנמצא בקבצים; ושאלה נחשבת כנענית כשהשורה שלה מסומנת בתוכנית, או שהלקוח ענה עליה בדף השאלות שלו.

שני דברים גורמים לתוכנית להתעכב, והמסך מציין איזה מהם: תהליך ה-AI שמעדכן את התוכנית אחרי שינוי לא הסתיים ("התוכנית הכתובה לא עודכנה אחרי השינוי האחרון", עם הסיבה), או שלאתר יש גרסה חדשה יותר מזו שהתוכנית נמדדה לפיה ("האתר השתנה אחרי העדכון האחרון של התוכנית"). במקרה כזה מופיע כפתור "רענון התוכנית". הדף לעולם לא מפעיל אותו לבד כשפותחים אותו (פתיחת דף אינה משתמשת ב-AI לעולם); המנוע כבר משלב כל שינוי בתוכנית ברקע, והכפתור קיים למקרה שזה נפל מאחור. רענון התוכנית משלב את השינוי האחרון בתוכנית הכתובה ומודד את האתר מחדש. אם זה עדיין לא מצליח, הפס נשאר עם תיאור הבעיה, ואפשר ללחוץ שוב על רענון התוכנית או לערוך את התוכנית ידנית.

כרטיס הבריאות מדרג את האתר מתוך 100 לפי כללים ש-aiKit בודק בקבצים האמיתיים, ולא לפי דעתו של ה-AI: כותרת דף או תיאור חיפוש חסרים או חוזרים, דף בלי כותרת ראשית או עם יותר מאחת, קישור לדף שאינו קיים, דף שאף דף לא מקשר אליו והתפריט לא כולל, תמונות בלי תיאור לקוראי מסך, דפים קצרים מאוד, טופס שאין לו לאן לשלוח, ומודול שהבריף דרש ואינו באתר. לכל בעיה מצוין באיזה דף היא נמצאת, למה היא חשובה, ויש כפתור "תיקון". "תיקון" שולח את ההוראה המוכנה של הבעיה כבקשה ומעביר אותה ל-AI; הכפתור מציג "התיקון התבקש" בזמן העבודה, והציון נמדד מחדש כשהשינוי נכנס. אפשר לסנן את הרשימה לפי חומרה באמצעות הספירות גבוהה, בינונית ונמוכה, ו"הצג הכול" מבטל את הסינון.

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

לחצו על כל דף (במפת האתר או ברשימת הדפים) כדי לפתוח את פרטיו לצד התוכנית. שורת הכתובת משתנה ל-?page=/about, כך שהקישור פותח את אותו דף לכל מי שבצוות. הפרטים מציגים איך הדף נראה בגוגל (כותרת, כתובת, תיאור), את הסעיפים והכותרות הראשיות שלו, מספר המילים, התמונות וכמה מהן חסרות תיאור, הטפסים שלו ואיזה מודול של הערכה מפעיל אותם, האם הלקוח אישר אותו, והשינוי האחרון: מתי, מי ביקש, ומה התבקש.

ההיסטוריה מציגה את הגרסאות ש-aiKit שומר (המקורית ו-10 האחרונות), מהחדשה לישנה: המספר שלה, סוג השינוי (בנייה ראשונה, צ'אט, נעיצה, ערכה, פרסום, שחזור, עריכת תוכנית), מתי, מה התבקש, מי ביקש, ואילו דפים השתנו (לחצו על דף כדי לפתוח את פרטיו). הגרסה החדשה מסומנת כגרסה הנוכחית; לכל גרסה ישנה יש "שחזר את הגרסה הזו", שמבקש אישור ושומר קודם את המצב הנוכחי לפני שמחזיר את האתר, כך שאפשר לבטל שחזור. מוצגות שלוש הראשונות; "הצג הכול" מציג את היתר.

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

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

לכל כרטיס סעיף יש את שני אותם הכפתורים. "ערוך" פותח את ה-Markdown הגולמי של הסעיף בתיבת טקסט פשוטה ושומר אותו ישירות בחזרה ל-PLAN.md. זו כתיבה אמיתית ומיידית (דרך נקודת הקצה PUT של הפרויקט), אבל היא בכוונה אינה מפעילה בנייה או פרסום; היא משנה רק את מה שמסמך התוכנית אומר, בדיוק כמו עריכת כל הערה אחרת.

"בקש שינוי" שונה בכוונה: הוא פותח טופס קטן ("איזה שינוי תרצה ב-<section>?"), ושליחתו יוצרת בקשה אמיתית בלשונית המשוב של הפרויקט — עם התווית "תוכנית אתר — <Section>: …" — בדיוק כמו כל הערה מוצמדת או בקשת עריכה מהירה, עם מחזור הסטטוס שלה וקישור "הצג את הבקשה" לאחר שליחתה. השתמש ב"ערוך" כשאתה מתקן או כותב מחדש את הטקסט של התוכנית בעצמך; השתמש ב"בקש שינוי" כשאתה רוצה שהאתר בפועל (ובתורו התוכנית) יעודכן בהתאם.

לתוכנית יש שתי שכבות. המדידות (עמודים, כותרות, מקטעים, קישורים, טפסים, מודולים, תקינות) נלקחות על ידי הקוד מהקבצים האמיתיים אחרי כל שינוי, כך שאינן יכולות להתסטות. התוכנית הכתובה (מטרות, עובדות עסקיות, מותג, החלטות, שאלות פתוחות) נשמרת מעודכנת על ידי מעבר של AI שרץ אחרי כל שינוי ומשכתב רק את החלקים שהשינוי נגע בהם. הוא לעולם לא מוסיף יומן שינויים או רשומות מתוארכות; ההיסטוריה היא המקום שבו נשמר תיעוד השינויים.

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

מסרגל לצד התוכנית מכיל את הפעולות (במכשיר נייד המסרגל הופך לכפתור "העתק את קישור הלקוח" ברוחב מלא מתחת לפס ההתקדמות, והשאר מקופל תחת "פעולות נוספות (3)"). "שתף עם הלקוח" מעתיק קישור לקריאה בלבד (aikit.ai/p/<project>/plan) — ללא כלי צוות, ללא כפתורי עריכה, ללא שום דבר פנימי. "פתח את האתר החי" הוא קישור ישיר לאתר החי, או שהמסרגל מציין בבירור "עדיין לא באוויר" אם הוא אינו באוויר. "קבצים" מציג את מספר הקבצים האמיתי עם רשימה נפתחת של נתיב וגודל של כל קובץ. "הורד את התוכנית" מוריד את קובץ PLAN.md הנוכחי והאמיתי כקובץ .md ממשי, זהה לחלוטin לבית לבית למה שהמסך קורא — ולא סיכום שנוצר מחדש.

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

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

כל מה שהצוות מסמן לעצמו נמחק בשרת לפני שהדף נשלח, בכל מקטע: שורה המכילה "(internal)", "[internal]" או "(staff only)", שורה המתחילה ב-"Internal:" או "Staff only:", כל מקטע שכותרתו אומרת Internal או Staff only, ותגובות מוסתרות. השורות האלה לעולם לא מגיעות לדפדפן של הלקוח, אפילו לא בנתוני הרשת של הדף.

לכל עמוד שנבנה יש כפתור אשר. הלקוח מקליד את שמו (והערה אופציונלית) ומאשר; האישור קשור לתוכן המדויק של אותו עמוד, ולכן אם העמוד ישתנה מאוחר יותר יופיע "השתנה מאז שאישרת" והמערכת תבקש שוב. רק מי שמשתמש בקוד הגישה של הלקוח יכול לאשר. אם תפתחו את קישור הלקוח כשאתם מחוברים כצוות, תראו את מצב האישור של כל עמוד אך לא כפתור אשר, כדי שאף אחד לא יוכל לאשר מטעם הלקוח. בתוכנית האתר של הצוות, עמודים שאושרו מציגים "אושר על ידי הלקוח" ואלה ששונו מציגים "השתנה מאז האישור".

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