‏تبدیل گزارش Lighthouse به CLAUDE.md برای Claude Code

lighthouse-md یه ابزار وب برای تبدیل خروجی Lighthouse (ابزار گوگل که کارایی، دسترس‌پذیری، Best Practices و SEO صفحه رو نمره می‌ده) به یه برنامه کاری برای Claude Code هست. خروجیش یه فایل CLAUDE.md هست، یعنی همون فایل مارک‌داونی که Claude Code از ریشه ریپو می‌خونه تا بفهمه پروژه چیه و چی کار باید بکنه.

روند کار چهار قدمه: URL رو می‌دی و حالت موبایل یا دسکتاپ رو انتخاب می‌کنی. بعد ابزار، PageSpeed Insights v5 رو صدا می‌زنه و Lighthouse تو کلاد گوگل حدود ۱۰ تا ۳۰ ثانیه اجرا می‌شه. هر audit که نمره‌ش زیر 0.9 باشه یه پیشنهاد اصلاح مشخص می‌گیره. آخرش می‌تونی Claude Code رو با پرامپت آماده باز کنی یا فایل CLAUDE.md رو دانلود کنی.

به گفته سازنده‌ها، فرقش با گزارش خام Lighthouse اینه که «مقصرهای اصلی» رو رتبه‌بندی می‌کنه: URL، selector و تیکه HTML دقیقی که مشکل رو ساخته، همراه با صرفه‌جویی احتمالی بر حسب میلی‌ثانیه یا کیلوبایت. فایل خروجی پروفایل throttling، اثر اسکریپت‌های third-party، تفکیک کار main thread و لیست auditهایی که الان پاس می‌شن رو هم داره. اون لیست آخری برای اینه که ایجنت موقع درست کردن یه چیز، چیز دیگه‌ای رو خراب نکنه.

دکمه «Ask Claude» از deep link به شکل claude://code/new استفاده می‌کنه و برای کار کردنش باید اپ دسکتاپ Claude Code نصب باشه. نسخه وب فقط روی آدرس‌های عمومی HTTPS کار می‌کنه، چون گوگل باید بتونه صفحه رو ببینه. برای staging خصوصی یه افزونه Chrome هم هست که تب فعلی رو با یه کلیک تست می‌کنه. سایت می‌گه URL روی سرورهاش ذخیره نمی‌شه و اکانت هم لازم نیست.

کنار ابزار یه کتابخونه توضیحی از auditهای رایج هم هست، مثل LCP زیر ۲.۵ ثانیه، TBT زیر ۲۰۰ میلی‌ثانیه، CLS زیر 0.1، کنتراست رنگ ۴.۵ به ۱، و مواردی مثل نبود تگ main یا لینک‌هایی که اسم قابل فهم ندارن.

نکات کلیدی:

• هر audit با نمره زیر 0.9 تو هر چهار دسته Lighthouse یه پیشنهاد اصلاح می‌گیره.
• تست از طریق PageSpeed Insights v5 تو کلاد گوگل اجرا می‌شه و ۱۰ تا ۳۰ ثانیه طول می‌کشه.
• فایل CLAUDE.md لیست auditهای پاس‌شده رو هم داره تا ایجنت اونا رو خراب نکنه.
• نسخه وب فقط آدرس عمومی HTTPS قبول می‌کنه؛ برای staging افزونه Chrome هست.
• دکمه Ask Claude به اپ دسکتاپ Claude Code نیاز داره.