এমনটা ঘটছে → কী করবেন
শিরোনাম দিয়ে নয়, উপসর্গ দিয়ে খোঁজা হয় এখানে। "কী করবেন"-এর নিচের লিংকে ক্লিক করলে সেই সমাধানটি যেখানে লেখা আছে সেই অংশে চলে যাবেন। লেখার তালিকা এই পাতার নিচে আছে, উলটো সূচির বাইরে।
এই টেবিলটি Claude Code (Anthropic-এর কোডিং এজেন্ট) ধরে নিয়ে লেখা। hook, CLAUDE.md, subagent ও auto memory হলো এর ফিচারের নাম।
সমস্যা হলে মানুষ যে বাক্যটি লেখে
「সব todo মুছে ফেলুন। https://typing-tube.net/articles/bn/lookup.md দেখুন, এই সেশনটি ফিরে দেখুন এবং কোনো সমস্যা আছে কি না পরীক্ষা করুন।」
এখান থেকে শুধু সমস্যার তালিকা পাওয়া যায়। কীভাবে ঠিক করবেন, তা আপনার নিজের প্রকল্প অনুযায়ী আপনি ঠিক করুন।
| এমনটা ঘটছে | প্রস্তাবিত সমাধান |
|---|---|
| No.1 AI যতবার টেস্ট চালায়, ততবার হাজার হাজার লাইনের আউটপুট context-এ ঢুকে পড়ে |
উদাহরণ:টেস্ট রান wrapper-এ একত্র করুন, AI-কে শুধু ব্যর্থতার সারাংশ দিন। |
| No.2 AI যত বেশি জ্ঞাননোট (knowledge note) memory-তে সংরক্ষণ করে, পরবর্তী প্রতিটি session-কে তত বেশি পড়তে হয় |
উদাহরণ:memory-তে লেখার আগে checklist পড়ান, প্রতিবার পড়া ফাইলে ১ লাইনই রাখুন। |
| No.3 টেস্ট pass করছে, কিন্তু সেগুলো আসলে কিছু রক্ষা করছে কিনা তা বোঝা যায় না |
উদাহরণ:AI-কে mutation testing করতে বলুন। |
| No.4 নিবন্ধিত skill AI কখনো ব্যবহার করে, কখনো করে না |
উদাহরণ:ভুল call ঢোকার মুখেই থামান, কোন ডকুমেন্ট পড়তে হবে তা দেখান। |
| No.5 sub-agent-কে দেওয়া কাজ শেষ না হওয়া পর্যন্ত ভেতরে কী ঘটছে বোঝা যায় না |
উদাহরণ:sub-agent-কে দেওয়া যায় এমন কাজ তালিকায় রাখুন, শুরুর আগে hook দিয়ে যাচাই করুন। |
| No.6 instruction file-এ যত বেশি নিয়ম যোগ করা হয়, আগের নিয়মগুলো তত কম মানা হয় |
উদাহরণ:"এটা করবেন না" প্রতিটি নিয়মকে লঙ্ঘন ধরতে পারা automated test-এ বদলান। |
| No.7 সমান্তরালে চলা session-গুলো যে memory শেয়ার করে সেটা অগোছালো হয়ে যায়; নীতি পড়িয়েও কাজ হয় না |
উদাহরণ:যা পড়ানো হচ্ছে তা না বদলে, save হওয়ার পরপরই দেখানোর সময়টুকু বদলান। |
| No.8 একই ভুলের সমাধান লিখে রাখলেও, AI পরের বার আবার সেই একই ভুল করে |
উদাহরণ:ব্যর্থতা শনাক্ত হওয়ার মুহূর্তেই retry-এর নীতি স্বয়ংক্রিয়ভাবে যোগ করুন। |
| No.9 handoff নোট আর completion report পড়েও দেখা যায়, অসুবিধাজনক অংশগুলো বাদ পড়ে গেছে |
উদাহরণ:completion report-এর পাশে মেশিনে গোনা সংখ্যা প্রতিবার রাখুন। |
| No.10 মেশিন যে সংখ্যা গুনেছে, রিপোর্টে পৌঁছানোর আগেই সেটা অন্য সংখ্যায় বদলে যায় |
উদাহরণ:সংখ্যার লাইনে নির্দিষ্ট prefix দিন, হুবহু কপি হয়েছে কিনা hook দিয়ে যাচাই করুন। |
| No.11 কাজ করার সময় AI-কে মাঝপথে থামালে, তারপরের কাজ এলোমেলো হয়ে যায় |
উদাহরণ:কাজ চলাকালীন হস্তক্ষেপ না করে ধাপ শেষ হওয়া পর্যন্ত অপেক্ষা করুন। হস্তক্ষেপ machine-এর হাতে ছেড়ে দিন। |
| No.12 session-এর শেষে কী পড়তে হবে আর কী পড়া লাগবে না তা ঠিক করা নেই |
উদাহরণ:ডেলিভারেবল বা কাজের log না পড়ে, শুধু exit code দিয়ে pass/fail দেখুন। |
| No.13 একবার প্রত্যাখ্যান করা প্রস্তাব পরের session-এ আবার ফিরে আসে |
উদাহরণ:বাতিল করা সিদ্ধান্তগুলো একটিমাত্র ডকুমেন্টে জড়ো করুন। |
| No.14 নিষেধের এক লাইন লিখে দেওয়ার পরও সেটা কখনো বেশি, কখনো কম অর্থে ব্যাখ্যা করা হয় |
উদাহরণ:প্রতিটি নিষেধের পাশে "কারণ" লিখুন, সিদ্ধান্তের সাথেই রাখুন। |
| No.15 নিষেধটি ঠিকভাবে লেখা থাকলেও মানা হয় না, আর প্রতিবার এ নিয়ে জিজ্ঞাসা আসে |
উদাহরণ:প্রতিটি নিষেধের পাশে "প্রযোজ্যতার সীমা" লিখুন, দ্বিধার সীমারেখাগুলো এক লাইনে দিন। |
| No.16 একই নির্দেশ একাধিক sub-agent-কে দিলে, প্রতিটি থেকে ফেরত আসা ফলাফলের আকার আলাদা হয় |
উদাহরণ:sub-agent-কে দেওয়া যায় এমন কাজের তালিকায়, শুরুর আগে দরকারি input স্পষ্ট করে লিখুন। |
| No.17 যেসব নিষেধের কোনো automated test নেই, সেগুলো শুধু লেখা অবস্থাতেই জমতে থাকে |
উদাহরণ:প্রতিটি নিষেধের জন্য সংশ্লিষ্ট automated test আছে কিনা তা স্পষ্ট করুন। |
| No.18 AI-এর কাজ প্রতিবার "স্ক্রিন খুলে দেখে নিন" বলে শেষ হয় |
উদাহরণ:pass/fail স্ক্রিনের চেহারা দিয়ে নয়, অবশিষ্ট data দিয়ে ঠিক করুন। |
| No.19 AI যখনই একটু অসংগত কিছু বলে, তখনই ব্যাখ্যা দিয়ে সেটা ঠিক করতে হয় |
উদাহরণ:মানুষ ব্যাখ্যা করে না ঠিক করে, hook আর automated test-এর failure message দিয়ে ফেরত দিন। |
| No.20 প্রত্যাখ্যাত সিদ্ধান্তের তালিকা ক্রমাগত বেড়ে চলেছে, একদিন হয়তো আর কেউ পড়বে না |
উদাহরণ:প্রত্যাখ্যাত প্রস্তাব ডকুমেন্টের শেষে "গৃহীত হয়নি" অংশে পাঠান। |
| No.21 instruction file-এর "অবশ্যই চালান" নির্দেশগুলো কমছেই না |
উদাহরণ:instruction file-এর "অবশ্যই চালান" কমান্ড machine-এর দিকেও আছে কিনা মিলিয়ে দেখুন। |
| No.22 পদ্ধতি পর্যন্ত লিখে দেওয়ার পরও, সেভাবে সমাধান হয়ে ফিরে আসে না |
উদাহরণ:পদ্ধতি নির্দেশ না করে, শুরুর আগে দরকারি input-টুকুই ঠিক করুন। |
| No.23 বাগ জানাতে প্রতিবারই ধাপগুলো আর উপসর্গ নিজে হাতে লিখতে হয় |
উদাহরণ:মানুষ শুধু উপসর্গের এক বাক্য লিখুক, বাকিটা স্বয়ংক্রিয়ভাবে সংগ্রহ হোক। |
| No.24 প্রতিবারই "আগে একটা plan দাও" লিখতে হয়, এটাই এক বাড়তি ঝামেলা |
উদাহরণ:একটি design ডকুমেন্ট রাখলেই AI সেই ধাঁচ অনুসরণ করবে। |
| No.25 যে লাইনগুলো মানানো সবচেয়ে জরুরি সেগুলোই সবচেয়ে জোর দিয়ে লেখা, কিন্তু তাতে কাজ হচ্ছে কিনা বোঝা যায় না |
উদাহরণ:প্রভাব মাপা বাদ দিয়ে, emphasis থাকা লাইনের সংখ্যা গুনে একটা সীমা ঠিক করুন। |
| No.26 sub-agent-এর ডেলিভারেবল প্রত্যাশা করা আকারের চেয়ে ভিন্নভাবে ফিরে আসে |
উদাহরণ:ডেলিভারেবলের acceptance criteria কাজ দেওয়ার আগেই ঠিক করে রাখুন। |
| No.27 ভুল খুঁজে পেলে "ঠিকমতো পড়েছিলে তো?" বলে জেরা করতে ইচ্ছা করে |
উদাহরণ:জেরা না করে, "...নয় কি?" প্রশ্নবোধক আকারে জিজ্ঞেস করুন। |
| No.28 ফিরে আসা উত্তরে "এটা তো ঠিক না" বলে ফেরত পাঠালেও উন্নতি হয় না |
উদাহরণ:মানুষ নিজে দোষ না ধরিয়ে, save হওয়ার পরপরই diff-এর সাথে নিষেধগুলো দেখান। |
| No.29 AI যে ফাইল খোলেইনি, সেটার ভেতরের কথা যেন খুলে দেখেছে এমনভাবে বলে |
উদাহরণ:রেফারেন্স আর কোড দুই জায়গাতেই একই identifier লিখতে বাধ্য করুন, সেই identifier সত্যিই আছে কিনা automated test দিয়ে দেখুন। |
| No.30 AI বারবার "A নাকি B, কোনটা নেব?" জিজ্ঞেস করতে থাকে, আর কাজ থেমে যায় |
উদাহরণ:সঙ্গে সঙ্গে উত্তর না দিয়ে, বাছাইয়ের মাপকাঠি machine-এর দিক থেকে ঠিক হোক। |
| No.31 AI-কে দিয়ে review করানো হচ্ছে, কিন্তু ও আসলে কী দেখছে না তা বোঝা যায় না |
উদাহরণ:স্ক্যান করেও সংখ্যার নিম্নসীমা নেই এমন automated test বাইরে থেকে গুনে খুঁজে বের করুন। |
| No.32 screenshot জমতে থাকে, কিন্তু কোনটা কী যাচাই করার জন্য নেওয়া তা বোঝা যায় না |
উদাহরণ:তোলার আগে "কী যাচাই করা হচ্ছে" লিখতে বলুন, সস্তা উপায় থেকে ক্রমে চেষ্টা করুন। |
| No.33 লিখে জানানোর একটি ধাপ রাখা হয়েছে, তবুও না লিখেই চলে যাওয়া রানের সংখ্যা গোনা যায় না |
উদাহরণ:screenshot বা E2E-এর আগে "কী যাচাই করা হচ্ছে" লিখতে বাধ্য করুন, না লিখলে চালাবেন না। |
| No.34 কোড না বদলালেও একই টেস্ট আবার চলে, আর সেই সময়টা বসে থাকতে হয় |
উদাহরণ:আগের log আবার পড়ার ব্যবস্থা করুন, একই রান বারবার চালাবেন না। |
| No.35 কিছুই না ভাঙার পরও, অচেনা এরর সারি সারি দেখা যায় |
উদাহরণ:টেস্ট চালানোর আগে exclusive lock নিন, না পেলে চালাবেন না। |
| No.36 "টেস্ট pass করছে" রিপোর্টে, যেই অংশ চলেইনি সেটার কথা লেখা থাকে না |
উদাহরণ:ভারী টেস্ট ডিফল্টভাবে skip করুন, চলেনি এমন এলাকার তালিকা প্রতিবার দিন। |
| No.37 কাজের পদ্ধতি বলে দেওয়া নির্দেশ আসলে মানা হয়েছে কিনা তা পরে বোঝার উপায় থাকে না |
উদাহরণ:নির্দেশ জোরালো না করে, পদ্ধতি মানার প্রমাণ ডেলিভারেবলে থেকে যাক এমন করুন। |
| No.38 বসানো wrapper মাঝপথে আবার কাঁচা কমান্ডে ফিরে যাচ্ছে |
উদাহরণ:নির্দেশ জোরালো না করে, কাঁচা কমান্ডে ফেরার কারণ এখনো আছে কিনা দেখুন। |
| No.39 একই প্রশ্ন বারবার করলে প্রতিবার আলাদা উত্তর আসে, আর সেগুলো একত্র করলে কিছু একটা হারিয়ে যায় |
উদাহরণ:একত্র করার আগে, প্রতিটি ধরনের পর্যবেক্ষণ কতগুলোর মধ্যে কতগুলোয় উঠেছে তা দিন। |
| No.40 "দরকার হলে ... করুন" লেখা লাইনটা আদৌ কার্যকর হয়েছিল কিনা বোঝা যায় না |
উদাহরণ:"দরকার হলে" না লিখে, সেই ধাপ পার না হলে পরেরটায় যাওয়া যাবে না এমন করুন। |
| No.41 "আরেকবার ভেবে দেখো" বললে উত্তর বদলায়, কিন্তু AI আসলে বুঝেছে কিনা তা বোঝা যায় না |
উদাহরণ:ফেরত না পাঠিয়ে, কোন premise ভুল তা নির্দিষ্টভাবে দেখান। |
| No.42 "অনুমান করো না" লিখে দেওয়ার পর থেকে AI কিছুই না বানিয়েই ফিরে আসতে শুরু করেছে |
উদাহরণ:শুধু নিষেধ না দিয়ে, "প্রযোজ্য নয়" লেখার একটা escape hatch একসাথে দিন। |
| No.43 ভালোভাবে চলা কথোপকথন চালিয়ে গেলে, যাচাই করার কাজ ক্রমশ বেড়ে যায় |
উদাহরণ:ধাপ শেষ হলে session শেষ করুন, পরেরটা নতুন session-এ শুরু করুন। |
| No.44 সব ডেলিভারেবল ঠিকই আছে, কিন্তু সেগুলোতে দেখা না যাওয়া অপচয় জমতে থাকে |
উদাহরণ:ডেলিভারেবল প্রস্তুত হলে, কাজের log একবার হিসাব করে দেখুন। |
| No.45 পরের মানুষের জন্য লিখে রাখা জ্ঞান বাস্তবের সাথে না মিলে পুরনো হয়ে যায় |
উদাহরণ:জ্ঞান ডকুমেন্টে না রেখে, থেমে যাওয়ার message-এর ভেতর বসিয়ে দিন। |
| No.46 কারণ খুঁড়তে খুঁড়তে, উত্তর পাওয়ার পরও পড়া চালিয়ে যাওয়া হয় |
উদাহরণ:কিছু না বদলে চলতে থাকা পড়ার সংখ্যা গুনুন, খোঁড়ার আগেই থামার শর্ত লিখুন। |
| No.47 যে model-এর দাম সবচেয়ে কম, সেটাকেই ব্যবহারের ক্ষেত্র না মেপে ডিফল্ট বানানো হয়েছে |
উদাহরণ:একই কাজ সস্তা ও দামি দুই model-কেই দিন, turn আর পরিমাণ গুনে তারপর ঠিক করুন। |
| No.48 কাজ না হলে, mechanism ঠিক করার বদলে বড় model-এ যাওয়া হয় |
উদাহরণ:একই কাজ দুই model-কেই দিন, শুধু সস্তা model যেখানে ব্যর্থ হয় সেটাকে automated test বানান। |
| No.49 মূল session নিজেই শেষ করতে পারত এমন খোঁজাখুঁজিও, সাবধানতাবশত sub-agent-কে দেওয়া হচ্ছে |
উদাহরণ:parent agent-এর কাছে আগে থেকে থাকা premise হলে দেবেন না, যা নেই শুধু সেই পড়াটুকু দিন। |
| No.50 ভাবনাচিন্তা ছাড়াই কাজটা চারভাগে ভেঙে একসাথে চালানো হচ্ছে |
উদাহরণ:sub-agent-কে যা দেবেন তা এক উত্তরে ফেরানো যায় এমন আকার পর্যন্ত। খরচ ঠিক করে সংখ্যা নয়, আসা-যাওয়ার বার। |
| No.53 কাজের মাঝপথে বাইরে থেকে "এটাও দেখো" বলে ঢুকিয়ে দেওয়া হচ্ছে |
উদাহরণ:ধাপ শেষ হওয়া পর্যন্ত অপেক্ষা করুন, পরিসর ছোট করে অনুরোধ করুন। "যথেষ্ট হলে যথেষ্ট লিখুন" যোগ করুন। |
| No.52 কোন model ব্যবহার করা হবে তা তুলনা করে ঠিক করা হচ্ছে |
উদাহরণ:তুলনা শুরুর আগে, সেই তুলনা কয়টা mechanism-এর সমান পরিশ্রম তা গুনুন। |
| No.51 "কোনো পার্থক্য পাওয়া যায়নি" বলে যাচাই-পর্ব গুটিয়ে ফেলা হচ্ছে |
উদাহরণ:গুটানোর আগে, হিসাব থেকে বাদ পড়া ফলাফল আর সব শর্তে শূন্য এমন আইটেম আবার গুনুন। |
| No.54 একদিন থেকে AI-এর কাজ করার ধরন বদলে গেছে, অথচ আপনি নির্দেশ বা সেটিংস কিছুই বদলাননি |
উদাহরণ:product-এর system prompt-এর সাথে সংঘর্ষ হয় এমন কিছু লিখবেন না, সেটা যা ঠিক করে দেয়নি শুধু তা যোগ করুন। ধরন বদলাতে চাইলে setting পাল্টান। |
লেখার তালিকা
এখান থেকে নিচের অংশ উলটো সূচির অংশ নয়; এগুলো লেখাগুলোর লিংক, প্রতিটি সিরিজ অনুযায়ী, ভূমিকা থেকে শেষ পর্ব পর্যন্ত।
はじめに —— 3 つの連載を、1 冊に
バイブコーディングにおける読まない技術
- 読まない技術 序論 AIの出力を、もうほとんど読んでいない
- 読まない技術 第1回 テスト結果を読まない技術
- 読まない技術 第2回 メモリを読まない技術
- 読まない技術 第3回 単体テストを読まない技術
- 読まない技術 第4回 スキルを使わない技術
- 読まない技術 第5回 サブエージェントの出力だけは読め
- 読まない技術 第6回 ルールを読まない技術
- 読まない技術 第7回 共有メモリを整理しない技術
- 読まない技術 第8回 修正履歴を読まない技術
- 読まない技術 第9回 引き継ぎを読まない技術
- 読まない技術 第10回 AIに要約しろと言わない技術
- 読まない技術 第11回 口を挟まない技術
- 読まない技術 第12回 作業結果を読まない技術
- 読まない技術 最終回 AIの出力を、ほとんど読まなくなった
AIの意見を聞かない技術
言わない技術
- 言わない技術 序論 AI に指示することが、ほとんどなくなった
- 言わない技術 第1回 検証を指示しない技術
- 言わない技術 第2回 具体的な指示を出さない技術
- 言わない技術 第3回 不具合詳細を書かない技術
- 言わない技術 第4回 計画を書けと言わない技術
- 言わない技術 第5回 念を押さない技術
- 言わない技術 第6回 サブエージェントの出力だけは、細かく指示しろ
- 言わない技術 第7回 AI を問い詰めない技術
- 言わない技術 第8回 AI にダメ出ししない技術
- 言わない技術 第9回 AI に考えさせない技術
- 言わない技術 第10回 質問に答えない技術
- 言わない技術 第11回 AI にレビューをさせない技術
- 言わない技術 最終回 何もしない技術
付録
はじめに —— 前巻の続きを、もう 1 冊に
確かめない技術
動かさない技術
追わない技術
番外編
- 番外編 A-1 整理する技術 —— 記録が増えたときに、何が起きているか
- 番外編 A-2 指示を残す技術 —— 「調べるだけ」が通らなかった日
- 番外編 A-3 参照するタイミングを変える技術 —— 2,000 行の壁
- 番外編 A-4 導出を依頼者の言葉と分ける技術 —— 誰も言っていない条件が、memory に載った日
- 番外編 A-5 memory を要約しない技術 —— 整理から、要約を抜く
- 番外編 A-6 責務で線を引く技術 —— 仕組みが増えたときに、どれを消すか
- 番外編 A-7 読まれたかを確かめる技術 —— 確かめるのをやめて、読めていない形を止めた
- 番外編 A-8 面積で数える技術 —— 読ませた量で数えていたら、102 倍外していました
- 番外編 A-9 ルールを短くする技術 —— 読みに来るのは、止められた直後の人です
- 番外編 B-1 連載を本にする技術 —— 本単位のスイッチでは、足りなかった日
- 番外編 C-1 校正の方法に、先に本編を当てる技術 —— AI が書いた方針に、その本自身の地雷が 10 個あった日
- 番外編 C-2 仕組みと人を分ける技術 —— 自動テストを置いたその手で、自動テストの外側で 2 度転んだ日
- 番外編 C-3 要素ごとに観点を変える技術 —— 一様に当てた点検が、要素をまたいだところで数を落とす
- 番外編 C-4 似た指示語を読み分ける技術 —— 1 字違いで、別の作業を頼んだことになる
- 番外編 C-5 作業の流れを見る技術 —— 終わりにしたつもりの日に、まだ起きていたこと
- 番外編 C-6 作業を進める技術 —— 選ぶ場面が、1 つも残らなかった日
- 番外編 C-7 読まずに止める技術 —— 決まったはずの判断が、1 分後に取り消されました
- 番外編 D-1 症状で読む —— 片付いた報告に、症状が混ざります
- 番外編 D-2 根拠で読む —— 突き合わせた報告に、症状が混ざります
- あとがき —— 本当の事実はどうでもいい話