Knaph

عمق ۱ · ۱۶۶ ثانیه

گزارشِ اشتباه

چهل ویرایشِ دقیق روی گزارشِ اشتباه. چرا پرهزینه‌ترین اشتباه‌های عامل برداشتِ نادرست از کار است، و برنامه‌ای که پیش از هر تغییری می‌خوانید چطور آن را وقتی پیدا می‌کند که با یک جمله درست می‌شود.

درباره‌ی این ویدیو

از عاملتان می‌خواهید گزارشِ فصلی را با عددهای تازه‌ی فروش به‌روز کند. بی‌درنگ دست به کار می‌شود: سی دقیقه، چهل ویرایش، سه نمودارِ تازه. وقتی نگاه می‌کنید، گزارشِ سالِ پیش را از نو ساخته، نه گزارشِ این فصل را، و چیدمانِ جدولی را هم که مدیرتان به آن تکیه دارد عوض کرده. تک‌تکِ ویرایش‌ها دقیق بودند؛ کلِ کار اشتباه بود.

ارزان‌ترین لحظه برای پیدا کردنِ این اشتباه پیش از اولین ویرایش بود. عامل درخواست را از همان اول اشتباه فهمید، همه‌ی گام‌های بعدی روی همان ساخته شدند، و مدل به‌ندرت برمی‌گردد تا انتخاب‌های قبلی‌اش را زیرِ سؤال ببرد. اگر در برنامه پیدا شود، با یک جمله درست می‌شود؛ اگر در پایان، یک بعدازظهر وقت می‌گیرد.

حالتِ برنامه‌ریزی شیوه‌ای از کار است که عامل در آن نگاه می‌کند اما دست نمی‌زند: می‌تواند فایل‌ها را بخواند، جست‌وجو کند و فکر کند، اما نمی‌تواند چیزی را ویرایش کند یا چیزی اجرا کند که تغییری بدهد. یک حالتِ اجازه است که در آن هر تغییری رد می‌شود. در Claude Code با Shift+Tab به آن می‌روید یا پیامتان را با فرمانِ plan شروع می‌کنید، و وقتی برنامه آماده شد می‌پرسد که ادامه بدهد یا نه. با هر عاملی هم می‌شود گفت: «فعلاً چیزی را تغییر نده. هر چه لازم است بخوان و برنامه‌ای به من بده.»

بررسیِ برنامه آسان است: چهل ویرایش را به‌آسانی نمی‌شود بازبینی کرد، اما ده خط برنامه را می‌شود خواند و دید «گزارشِ اشتباه» یا «چیدمان را عوض نکن». برنامه را برای پیدا کردنِ برداشتِ نادرست بخوانید، نه کلمه‌ی نادرست: هدفی که اشتباه فهمیده شده، بخشی که جا افتاده، تغییری در چیزی که باید بماند. برنامه‌ی تأییدشده در زمینه می‌ماند و کارِ طولانی را در مسیر نگه می‌دارد؛ هر گام را طوری بنویسید که به چیزی قابلِ بررسی برسد، و برای کارِ بزرگ از عامل بخواهید برنامه را در فایلی ذخیره کند. اگر باز هم خراب شد، Claude Code نقطه‌های بازگشت نگه می‌دارد و فرمانِ rewind گفت‌وگو، فایل‌ها یا هر دو را برمی‌گرداند (فایل‌هایی که فقط با فرمان‌های اجراشده تغییر کرده‌اند پوشش داده نمی‌شوند، پس کارتان را در git نگه دارید). این ویدیو برنامه‌ریزی پیش از کار را در Knaph توضیح می‌دهد.

این ویدیو عمق ۱ از «برنامه‌ریزی پیش از کار» را نشان می‌دهد.

یادگیری برنامه‌ریزی پیش از کار

متن گفتار

  1. ۰:۰۰از عاملتان می‌خواهید گزارشِ فصلی را با عددهای تازه‌ی فروش به‌روز کند.
  2. ۰:۰۶بی‌درنگ دست به کار می‌شود. سی دقیقه. چهل ویرایش. سه نمودارِ تازه.
  3. ۰:۱۱گزارشِ سالِ پیش را ساخته و چیدمانِ جدولِ مدیرتان را هم عوض کرده.
  4. ۰:۱۷تک‌تکِ ویرایش‌ها دقیق بودند.
  5. ۰:۲۰پس کِی پیدا کردنِ اشتباه از همه ارزان‌تر بود؟
  6. ۰:۲۴پیش از اولین ویرایش. درخواست را از همان اول اشتباه فهمید.
  7. ۰:۲۹همه‌ی گام‌های بعدی روی همان ساخته شدند، و مدل به‌ندرت برمی‌گردد تا انتخاب‌های خودش را زیرِ سؤال ببرد.
  8. ۰:۳۶پرهزینه‌ترین اشتباه‌های عامل همین شکلی‌اند. برداشتی نادرست از کار، که خیلی خوب انجام شده.
  9. ۰:۴۲پس بگذارید اول برنامه را بنویسد و بایستد. این حالتِ برنامه‌ریزی است.
  10. ۰:۴۷عامل می‌تواند فایل‌ها را بخواند، بگردد و فکر کند.
  11. ۰:۵۰اما نمی‌تواند ویرایش کند یا چیزی اجرا کند که تغییری بدهد.
  12. ۰:۵۵یک حالتِ اجازه است که در آن هر تغییری رد می‌شود.
  13. ۰:۵۹در Claude Code کلیدهای Shift و Tab را بزنید، یا پیامتان را با فرمانِ plan شروع کنید.
  14. ۱:۰۶با یک برنامه برمی‌گردد. ده خطی که واقعاً می‌شود خواند.
  15. ۱:۱۱گامِ اول، باز کردنِ گزارشِ سالِ پیش. گزارشِ اشتباه. یک جمله درستش می‌کند.
  16. ۱:۱۶گامِ چهارم، چیدمانِ تازه برای جدول. نه، چیدمان بماند.
  17. ۱:۲۰چهل ویرایش را به‌آسانی نمی‌شود بازبینی کرد. ده خط برنامه را می‌شود خواند.
  18. ۱:۲۵فقط وقتی تأیید کنید شروع می‌کند.
  19. ۱:۳۰بعد طبقِ برنامه کار می‌کند.
  20. ۱:۳۳برنامه‌ی تأییدشده در زمینه می‌ماند و کارِ طولانی را در مسیر نگه می‌دارد.
  21. ۱:۳۸هر گام به چیزی برسد که بشود بررسی کرد. بعد بایست و جدول را نشانم بده.
  22. ۱:۴۴برای کارِ بزرگ، بخواهید برنامه را در فایلی ذخیره کند و گام‌ها را یکی‌یکی علامت بزند.
  23. ۱:۵۲برنامه را که می‌خوانید، دنبالِ برداشتِ نادرست بگردید، نه کلمه‌ی نادرست.
  24. ۱:۵۷هدفی که اشتباه فهمیده شده.
  25. ۲:۰۰بخشی که جا افتاده، مثلِ عددهای اسفند.
  26. ۲:۰۳تغییری در چیزی که باید همان‌طور بماند.
  27. ۲:۰۸همین‌ها هستند که یک بعدازظهر کارِ برگرداندن می‌شوند.
  28. ۲:۱۴و اگر باز هم خراب شد، بدانید چطور برگردید.
  29. ۲:۱۸Claude Code حینِ کار نقطه‌های بازگشت نگه می‌دارد. فرمانِ rewind گفت‌وگو، فایل‌ها یا هر دو را برمی‌گرداند.
  30. ۲:۲۵فایل‌هایی که فقط فرمان‌ها عوض کرده‌اند برنمی‌گردند. کارتان را در git نگه دارید.
  31. ۲:۳۰زود برگردید و برنامه را درست کنید، به جای وصله کردن روی اشتباه.
  32. ۲:۳۶برنامه‌ی اشتباه یک جمله هزینه دارد. گزارشِ اشتباه یک بعدازظهر.