Quality & tools
מבקר חיצוני
בדיקה נייטרלית של הפרויקט בידי מנוע AI חיצוני, פעם בחודש. מסמך שאלות להדבקה במודל אחר (Codex, Antigravity, GPT) עם הריפו פתוח: שישה חלקים של 10 נקודות, ההקשר שבודקים קודמים פספסו, ופורמט תשובה שאפשר לבדוק.
#nr-log
הבדיקות שנעשו
| תאריך הבדיקה | מודלים | נקודות | טופל |
|---|---|---|---|
| 27.10.2026 | Codex, Antigravity | כ-120 (60 + 60) | 28.10.2026 |
הדוחות עצמם נמחקים אחרי הטיפול, ומה שלמדו מהם עבר לקוד, ל-CLAUDE.md, לסקילים ולדוקס. הבדיקה הבאה: בערך חודש אחרי השורה האחרונה.
#nr-prompt
הפרומפט המלא
מעתיקים במלואו ומדביקים במודל החיצוני. השאלות של כל חלק מופיעות גם למטה.
אתה בודק חיצוני ונייטרלי של הפרויקט v0-project-overview (Next.js, Tailwind v4). קרא קודם את CLAUDE.md בשורש, ואת app/demos/CLAUDE.md.
ההקשר, כדי לא ליפול במלכודות שבודקים קודמים נפלו בהן:
- בפרויקט שלושה דברים: אתר הסטודיו, הארסנל (components/, styles/) והדמואים (app/demos). דמו הוא הוכחת יכולת, לא אתר לקוח. אל תשפוט אותו כאתר לקוח גמור.
- טפסי הדמו (DemoForm) לא שולחים בכוונה. זה לא באג.
- /demos ו-/docs חסומים לגוגל (noindex) בכוונה. תאריך בשם תיקיית דמו הוא בכוונה.
- components/ui הוא shadcn כפי שהותקן, מחצבה. לא עורכים אותו.
- כלל שכתוב ב-CLAUDE.md הוא החלטה, לא טעות. אפשר לחלוק עליו, אבל לסמן את זה כדעה.
הכללים של הבדיקה:
- כל טענה עם ראיה: נתיב קובץ ושורה, או פקודה שהרצת והתוצאה שלה עם תאריך. "lint נכשל" רק אחרי npm run lint אמיתי.
- ספירות במספרים אמיתיים מהקוד, לא בהערכה.
- לכל נקודה אחד משלושה: נכון (עם התיקון המוצע), לא נכון (עם הראיה), או דעה.
- בלי שבחים שלא דורשים פעולה. נקודה שהכל בה תקין: שורה אחת.
החלקים, 10 נקודות לכל אחד:
1. ההנחיות מול המציאות (10 נקודות)
- איפה CLAUDE.md מתאר את הקוד נכון, ואיפה נוצר פער? לכל פער: הציטוט מההנחיות והקובץ שסותר אותו.
- אילו כללים כתובים אבל לא נאכפים, ואילו נאכפים בבדיקה (ESLint, check:*)?
- מה בהנחיות כבר לא נכון היום, או מיותר?
2. הארסנל: מתי להשתמש במה (10 נקודות)
- האם מודל שמקבל תוכן של עמוד יודע לבחור רכיב? בדקו מול /docs/by-content ו-app/docs/_fits.ts.
- אילו רכיבים כמעט לא בשימוש, ולמה? (ספירה של imports מחוץ ל-/docs)
- איפה יש שני רכיבים לאותו תפקיד?
3. הסקיל לבניית דמו, st-template-creator-light (10 נקודות)
- האם הסקיל מוביל לדמו שמשתמש בארסנל, או לכתיבה מאפס?
- מה חסר בו או סותר את CLAUDE.md?
- אילו שלבים אפשר להפוך לסקריפט במקום להנחיה?
4. הדוקס כארסנל עבודה מול AI (10 נקודות)
- מה מודל צריך מהדוקס כדי לבנות, ומה חסר לו? (לאיזה תוכן, השאלה, מבנה, קוד מוכן)
- אילו דפים לא רשומים ב-app/docs/_docs-pages.ts או בחיפוש?
- איפה הדוקס סותרים את הקוד?
5. ליבת המערכת והארכיטקטורה (10 נקודות)
- app/layout.tsx, האתחול הגלובלי (es-scripts/_init/uk_global_init.tsx, es-scripts/uk-global-scripts.ts): מה המחיר, מה שביר?
- משקל: מה כל עמוד טוען גם אם לא צריך?
- איפה אותו באג תוקן כמה פעמים בכמה מקומות, ומה רכיב הבסיס שחסר?
6. הדמואים (10 נקודות)
- האם כל דמו מוכיח משהו ומלמד אותו? אילו דמואים חלשים?
- האם הדמואים שומרים על כללי הפרויקט (טוקנים, קבצי data, דפי שרת, קישורים)?
- מה מכל דמו ראוי לעלות לארסנל?
פורמט התשובה, לכל נקודה:
מספר · כותרת · נכון / לא נכון / דעה · הראיה (קובץ:שורה או פקודה ותוצאה) · התיקון המוצע, במשפט.#nr-md
1. ההנחיות מול המציאות (10 נקודות)
- איפה CLAUDE.md מתאר את הקוד נכון, ואיפה נוצר פער? לכל פער: הציטוט מההנחיות והקובץ שסותר אותו.
- אילו כללים כתובים אבל לא נאכפים, ואילו נאכפים בבדיקה (ESLint, check:*)?
- מה בהנחיות כבר לא נכון היום, או מיותר?
#nr-arsenal
2. הארסנל: מתי להשתמש במה (10 נקודות)
- האם מודל שמקבל תוכן של עמוד יודע לבחור רכיב? בדקו מול /docs/by-content ו-app/docs/_fits.ts.
- אילו רכיבים כמעט לא בשימוש, ולמה? (ספירה של imports מחוץ ל-/docs)
- איפה יש שני רכיבים לאותו תפקיד?
#nr-skill
3. הסקיל לבניית דמו, st-template-creator-light (10 נקודות)
- האם הסקיל מוביל לדמו שמשתמש בארסנל, או לכתיבה מאפס?
- מה חסר בו או סותר את CLAUDE.md?
- אילו שלבים אפשר להפוך לסקריפט במקום להנחיה?
#nr-docs
4. הדוקס כארסנל עבודה מול AI (10 נקודות)
- מה מודל צריך מהדוקס כדי לבנות, ומה חסר לו? (לאיזה תוכן, השאלה, מבנה, קוד מוכן)
- אילו דפים לא רשומים ב-app/docs/_docs-pages.ts או בחיפוש?
- איפה הדוקס סותרים את הקוד?
#nr-core
5. ליבת המערכת והארכיטקטורה (10 נקודות)
- app/layout.tsx, האתחול הגלובלי (es-scripts/_init/uk_global_init.tsx, es-scripts/uk-global-scripts.ts): מה המחיר, מה שביר?
- משקל: מה כל עמוד טוען גם אם לא צריך?
- איפה אותו באג תוקן כמה פעמים בכמה מקומות, ומה רכיב הבסיס שחסר?
#nr-demos
6. הדמואים (10 נקודות)
- האם כל דמו מוכיח משהו ומלמד אותו? אילו דמואים חלשים?
- האם הדמואים שומרים על כללי הפרויקט (טוקנים, קבצי data, דפי שרת, קישורים)?
- מה מכל דמו ראוי לעלות לארסנל?
