Reticle: چککردن واقعی کار ایجنتهای کدنویسی
خلاصهٔ کاملتر
سازندههای Reticle میگن مشکل ایجنتهای کدنویسی اینه که کد رو مینویسن، فرض میکنن درسته و میرن سراغ کار بعد، بدون اینکه اپ رو باز کنن. نتیجهش یه modal خراب، یه خطای 500 بیصدا یا پیام «Deploy succeeded» روی یه deploy شکستخوردهست که آخرش خودت باید پیداش کنی. به گفتهٔ اونا ایجنت ذاتاً خوشبینه چون برای ساختن تغییر طراحی شده، ولی verification باید آماده باشه که جواب «نه» بده.
Reticle یه SDK کوچیک و فقط مخصوص محیط توسعه رو داخل اپ میذاره و از طریق MCP (یعنی پروتکلی که ایجنتها باهاش به ابزارهای بیرونی وصل میشن) به ایجنت ابزارهایی برای دیدن، عملکردن و assert کردن میده. چون از داخل اپ میخونه، چیزایی رو میبینه که رو صفحه پیدا نیستن: درخواستی که یه کلیک فرستاده و جوابش، state واقعی storeها (مثل zustand، Redux، TanStack Query و Pinia)، خطاهای کنسول و رندرهای React. هر چک با یه verdict تموم میشه: yes، no یا unknown، همراه مدرک و file:line جایی که باید درست بشه.
نکتهٔ مهم اینه که فقط yes قبول حساب میشه و اگه ابزار نتونه تصمیم بگیره، unknown رو با دلیلش برمیگردونه و هیچوقت سبز الکی نشون نمیده. یه جریان رو که چک کردی میتونی بهعنوان flow ذخیره کنی تا بعداً بدون مدل هوش مصنوعی و بهصورت قطعی دوباره اجرا بشه. دستور reticle gate هم تو CI جلوی تغییری رو میگیره که کد یه flow ذخیرهشده رو عوض کرده ولی اجرای موفق جدید نداره.
برای شروع، دستور npx @reticlehq/server تو پوشهٔ اپ بدون نصب چیزی سرور توسعه رو پیدا میکنه، صفحه و حداکثر ۸ لینک همدامنه رو چک میکنه و verdict میده. بعد init پکیجهای توسعه رو اضافه میکنه، تنظیمات build رو عوض میکنه و Reticle رو تو ایجنتهایی مثل Claude Code، Cursor، Codex و Gemini CLI ثبت میکنه. از React، Next.js، Vue، Svelte و Angular و همینطور Electron و Tauri پشتیبانی میشه.
از نظر امنیت، SDK تو build پروداکشن نیست، bridge فقط روی 127.0.0.1:4400 گوش میده و تا وقتی پروژه رو لینک نکنی هیچ دادهای از اپ خارج نمیشه. ابزاری برای اجرای جاوااسکریپت دلخواه تو صفحه نداره و رمزها و توکنها رو با [REDACTED] عوض میکنه. پکیجها با لایسنس Apache-2.0 و SLSA provenance منتشر میشن و install script ندارن. فقط حواست باشه که آمار استفادهٔ ناشناس بهصورت پیشفرض روشنه و با DO_NOT_TRACK=1 خاموش میشه.
نکات کلیدی:
- سه نوع verdict: yes، no و unknown، همراه مدرک و file:line
- state واقعی storeهایی مثل zustand، Redux و Pinia رو میخونه، نه فقط DOM رو
- flowهای ذخیرهشده بدون مدل AI و بهصورت قطعی دوباره اجرا میشن
- reticle gate تو CI تغییرات بدون اجرای موفق جدید رو رد میکنه
- نیاز به Node 20.11 یا بالاتر؛ bridge فقط روی 127.0.0.1:4400
- telemetry ناشناس پیشفرض روشنه و با RETICLE_TELEMETRY=0 یا DO_NOT_TRACK=1 خاموش میشه




