SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-10-26

কোডিং এজেন্ট কেন আপনার নির্দেশ উপেক্ষা করে?

আপনার নির্দেশ উপেক্ষা করার পেছনে কনটেক্সট উইন্ডোর সীমাবদ্ধতা বা অস্পষ্ট নিয়ম দায়ী হতে পারে। এজেন্ট কেন ভুল করছে তা বুঝতে এই নিবন্ধে বর্ণিত ডায়াগনস্টিক পদ্ধতিটি ব্যবহার করে দেখুন।

কোডিং এজেন্ট আপনার নির্দেশনা উপেক্ষা করে

কোডিং এজেন্ট আপনার নির্দেশনা উপেক্ষা করার চারটি কারণ আছে। এর কোনোটিই আপনি যথেষ্ট ভদ্র ছিলেন না—এটি নয়। নিয়মটি কখনো context window-এ ছিল না। নিয়মটি এত অস্পষ্ট ছিল যে কোনো কাজের সঙ্গে মিলিয়ে তা যাচাই করা যায়নি। Context-এর অন্য কোনো অংশ নিয়মটির সঙ্গে বিরোধ করেছে; সাধারণত agent যে code এইমাত্র পড়েছে, সেটিই এর কারণ। অথবা নিয়মটি এখনো loaded আছে, কিন্তু বর্তমান turn থেকে অনেক দূরে অবস্থান করছে এবং agent কাছের বিষয়গুলোর ভিত্তিতে কাজ করছে।

প্রতিটি কারণের সমাধান আলাদা। তাই প্রথম কাজ হলো কারণগুলো আলাদা করে শনাক্ত করা। বড় হাতের অক্ষর এবং IMPORTANT শব্দ ব্যবহার করা কোনো diagnosis নয়। নিচের ব্যাখ্যায় Claude Code-কে উদাহরণ হিসেবে ব্যবহার করা হয়েছে, কারণ October 2026 পর্যন্ত এর loading ও compaction behaviour বিস্তারিতভাবে documented। অন্যান্য tool-এর খুঁটিনাটি ভিন্ন হলেও সামগ্রিকভাবে তারা একইভাবে কাজ করে।

প্রথমে দুটি term জেনে নিন। context window হলো একটি নির্দিষ্ট turn-এ model যে text block দেখে: system prompt, আপনার instruction file, conversation এবং agent যে প্রতিটি file পড়েছে—সবকিছু। harness হলো model-কে ঘিরে থাকা program; এটি disk থেকে file পড়ে এবং সেই block তৈরি করে। এই post-এর প্রায় প্রতিটি অভিযোগ আসলে model সম্পর্কে নয়, harness সম্পর্কে অভিযোগ।

আপনার ইনস্ট্রাকশন ফাইলটি কোনো সেটিং নয়, বরং একটি বার্তা

একটি ইনস্ট্রাকশন ফাইল কনফিগারেশন নয়। রানটাইমে কোনো কিছুই CLAUDE.md পড়ে না এবং এটি কার্যকর করে না। হারনেস ডিস্ক থেকে ফাইলটি পড়ে এবং টেক্সটটিকে কথোপকথনে পেস্ট করে। Claude Code-এ এই বিষয়বস্তু সিস্টেম প্রম্পটের পরে একটি ব্যবহারকারী বার্তা হিসেবে প্রদান করা হয়, যার অর্থ হলো মডেলটি আপনার নিয়মগুলোকে ঠিক সেভাবেই দেখে যেভাবে আপনি টাইপ করা অন্য কিছু দেখে।

এর একটি অস্বস্তিকর ফলাফল রয়েছে। আপনার নিয়মগুলো উইন্ডোতে থাকা অন্য সব টেক্সটের সাথে সমানভাবে প্রতিযোগিতা করে। একটি নিয়ম হলো একটি দাবি। এজেন্ট এইমাত্র যে ফাইলটি খুলেছে তা হলো প্রমাণ। যখন এই দুটির মধ্যে অমিল থাকে, তখন প্রায়শই প্রমাণটি জয়ী হয় এবং কোনো এরর তৈরি হয় না, কারণ মডেলের দৃষ্টিভঙ্গি থেকে কোনো ভুল হয়নি।

অফিসিয়াল ডকুমেন্টেশনে এটি স্পষ্টভাবে বলা হয়েছে: ইনস্ট্রাকশন ফাইলগুলোকে কনটেক্সট হিসেবে বিবেচনা করা হয়, কার্যকর করা কনফিগারেশন হিসেবে নয়। মডেল যা-ই সিদ্ধান্ত নিক না কেন, কোনো কাজকে ব্লক করতে হলে আপনার একটি হুক প্রয়োজন, কোনো বাক্য নয়। এই বিষয়টি মনে রাখুন। এই পোস্টের শেষে দেওয়া বেশিরভাগ সমাধানই হলো কোনো নির্দিষ্ট ক্ষেত্রে এই লাইনের প্রয়োগ।

কোন নির্দেশনা ফাইল লোড হয় এবং কখন

Claude Code আপনি যে ডিরেক্টরি থেকে এটি চালু করেছেন, সেখান থেকে directory tree ধরে উপরের দিকে যায়। filesystem root থেকে আপনার working directory পর্যন্ত প্রতিটি CLAUDE.md এবং CLAUDE.local.md launch-এর সময় সম্পূর্ণ লোড হয়। এগুলো ওই ক্রমেই একত্র করা হয়। তাই আপনি যে directory থেকে Claude Code চালু করেছেন, তার সবচেয়ে কাছের ফাইলটি সর্বশেষ পড়া হয়। একই directory-তে .local ফাইলটি মূল ফাইলের পরে যুক্ত হয়।

আপনার working directory-এর নিচের subdirectory-গুলোর ফাইল ভিন্নভাবে কাজ করে। এগুলো launch-এর সময় লোড হয় না। agent যখন ওই directory-র কোনো ফাইল পড়ে, তখন এগুলো লোড হয়। .claude/rules/-তে paths: frontmatter field-যুক্ত path scoped rule-এর ক্ষেত্রেও একই কথা প্রযোজ্য। matching file পড়ার সময় এগুলো context-এ যুক্ত হয়, প্রতিটি turn-এ নয়। v2.1.309 থেকে এইভাবে লোড হওয়া ফাইলের ক্ষেত্রেও প্রতি ফাইলের size limit আছে। 200K context window-তে limit হলো 40,000 characters। তাই বড় কোনো nested file-এর শুধু শুরুর অংশ agent পায়। ফলে ফাইলের শেষের দিকে থাকা rule কখনো context-এ পৌঁছাতে নাও পারে।

এই একটি পার্থক্যই রিপোর্ট করা ব্যর্থতার বড় অংশ ব্যাখ্যা করে। আপনি packages/api/CLAUDE.md-এ একটি rule রাখলেন, API সম্পর্কে প্রশ্ন করলেন, কিন্তু agent packages/api/-এর অধীনে কোনো ফাইল না খুলেই উত্তর দিল। rule-টি উপেক্ষা করা হয়নি। এটি কখনো context-এ উপস্থিতই ছিল না। আপনার repository যদি monorepo-তে প্রতি package-এর instruction file-এ guidance ভাগ করে রাখে, তাহলে প্রতিবার প্রথমে এটিই পরীক্ষা করুন।

AGENTS.md-কে standard হিসেবে গ্রহণ করা repository-গুলোর ক্ষেত্রে আরও একটি loading trap আছে। v2.1.277 থেকে Claude Code ডিফল্টভাবে AGENTS.md-কে project instructions হিসেবে পড়ে। তবে এটি তখনই হয়, যখন আপনার working directory বা তার উপরের কোনো directory-তে CLAUDE.md, .claude/CLAUDE.md অথবা CLAUDE.local.md না থাকে। আপনার ব্যক্তিগত ~/.claude/CLAUDE.md এখানে গণনা করা হয় না। এগুলোর যেকোনো একটি যোগ করলে, এমনকি ব্যক্তিগত note-এর জন্য একটি CLAUDE.local.md যোগ করলেও, Claude Code তার বদলে আপনার CLAUDE.md ফাইল পড়ে এবং AGENTS.md সম্পূর্ণ বাদ দেয়। উভয়টি লোড করতে Project instructions-কে claude-md-and-agents-md হিসেবে /config-এ সেট করুন। v2.1.277-এর আগের version-এ, অথবা আপনি যদি একটি CLAUDE.md রাখতে চান, তাহলে bridge হিসেবে CLAUDE.md ব্যবহার করুন। এর প্রথম line হবে @AGENTS.md। এটি launch-এর সময় ফাইলটি import করে। এর নিচে Claude specific note যোগ করা যায়। অতিরিক্ত কিছু যোগ করার না থাকলে symlink-ও কাজ করে। এই ফাইলে শুরু থেকেই কী রাখা উচিত, সেটি আলাদা প্রশ্ন। agent instruction ও human documentation আলাদা করে ভাগ করা অংশে তা ব্যাখ্যা করা হয়েছে।

ফাইলটি পুনর্লিখনের আগে লোড হয়েছে কি না নিশ্চিত করুন

Agent ফাইলটি দেখতে পাচ্ছে—এমন প্রমাণ না পাওয়া পর্যন্ত এর বক্তব্য পরিবর্তন করবেন না। এখানে দুটি পরীক্ষা আছে। আগে সহজ পরীক্ষাটি চালান।

সেশনের মধ্যে /context চালান। এটি বর্তমান window-কে category অনুযায়ী দেখায়, এবং Memory files তালিকায় launch-এর সময় লোড হওয়া প্রতিটি instruction file-এর নাম থাকে। কোনো ফাইল এই তালিকায় না থাকলে launch-এর সময় সেটি লোড হয়নি। তাই কোনো কিছু সেটির মধ্যে লিখলেও তা কার্যকর হবে না, যতক্ষণ না কোনো প্রক্রিয়া সেটি লোড করে। subdirectory-এর nested file এই তালিকায় কখনো দেখা যায় না, কারণ সেটি on demand লোড হয়। লোড হলে terminal-এ তার path-সহ একটি Loaded line দেখা যায়। /memory ফাইলগুলোর অবস্থান দেখায় এবং সেগুলো editing-এর জন্য খোলে; এখনো অস্তিত্বহীন ফাইলও এর অন্তর্ভুক্ত।

আরও নির্ভরযোগ্য তথ্যের জন্য load event log করুন। কোনো CLAUDE.md বা rules file context-এ প্রবেশ করলেই InstructionsLoaded hook event চালু হয়। এর matcher load হওয়ার কারণ জানায়: session_start, nested_traversal, path_glob_match, include অথবা compact। এটি .claude/settings.json-এ রাখুন:

{
  "hooks": {
    "InstructionsLoaded": [
      {
        "matcher": "nested_traversal",
        "hooks": [
          {
            "type": "command",
            "command": "cat >> /tmp/instructions-loaded.log"
          }
        ]
      }
    ]
  }
}

hook standard input-এ JSON হিসেবে payload পায়। তাই cat সম্পূর্ণ record যোগ করে। কাজ করার সময় tail -f /tmp/instructions-loaded.log দিয়ে এটি দেখুন। এই event-এর exit status উপেক্ষা করা হয়। তাই hook শুধু পর্যবেক্ষণ করতে পারে, load বন্ধ করতে পারে না। কোনো session-এ nested file লোড হওয়ার কথা থাকলেও যদি সেটি ওই log-এ না দেখা যায়, তাহলে পুনরায় wording পরিবর্তন করা বন্ধ করুন। সমস্যা file-এর অবস্থানে। একটি ব্যতিক্রম আছে: Claude Code সরাসরি পড়ে এমন AGENTS.md এই event চালু করে না। তাই তার path /memory-এ খুঁজুন। কোনো CLAUDE.md থেকে imported AGENTS.md স্বাভাবিক নিয়মেই এই event চালু করে।

দীর্ঘ session আপনার rules-এর ওপর কী প্রভাব ফেলে

এখানে দুটি পৃথক প্রভাব কাজ করে এবং এদের জন্য ভিন্ন প্রতিক্রিয়া প্রয়োজন।

দূরত্ব। Compaction চলার আগে turn 1-এ দেওয়া একটি rule turn 90-এও context window-তে থাকে। তবে তখন এটি সাম্প্রতিক এবং আপনার বর্তমান কাজের সঙ্গে বেশি সম্পর্কিত 90টি turn-এর text-এর সঙ্গে প্রতিযোগিতা করে। Compaction চলার পরে আপনি chat-এ একবার লিখেছেন এমন কোনো rule window-তে একেবারেই নাও থাকতে পারে। Claude Code-এর documentation-এ সতর্ক করা হয়েছে যে conversation-এর শুরুর দিকের instruction হারিয়ে যেতে পারে। এটি নিচের দ্বিতীয় প্রভাব। Distance configuration দিয়ে সরিয়ে দেওয়া যায় না, তবে এটি মাপা যায়। একই task একটি নতুন session-এ চালান। সেখানে rule কাজ করলে এবং দীর্ঘ session-এর অনেক পরে ব্যর্থ হলে, distance অথবা compaction-ই কারণ।

Compaction। Window পূর্ণ হলে harness এ পর্যন্ত conversation-এর একটি summary তৈরি করে এবং সেই summary থেকে কাজ চালিয়ে যায়। Summary-তে যা থাকে, তা summariser গুরুত্বপূর্ণ মনে করেছে। আপনি যা গুরুত্বপূর্ণ মনে করেন, তার সঙ্গে এটি এক নয়। Claude Code প্রতিটি mechanism-এর ফলাফল আলাদাভাবে document করেছে এবং পার্থক্যগুলো বড়। Project root CLAUDE.md এবং unscoped rules compaction-এর পরে disk থেকে আবার re-inject করা হয়। Auto memory disk থেকে আবার re-inject করা হয়। paths: frontmatter-যুক্ত rules কোনো matching file আবার read না হওয়া পর্যন্ত হারিয়ে যায়। Subdirectory-র nested CLAUDE.md files সেই subdirectory-র কোনো file আবার read না হওয়া পর্যন্ত হারিয়ে থাকে।

ওই table অনুযায়ী আপনার instruction-গুলো rank করলে fragility-এর ক্রম স্পষ্ট হয়। আপনি chat-এ একবার লিখেছেন এমন rule session-এর সবচেয়ে fragile উপাদান। Summary-তে সেটি থেকে গেলে তবেই এটি টিকে থাকে। packages/api/CLAUDE.md-এ থাকা rule পরের অবস্থানে, কারণ এটি একবার load হওয়ার পর summary-তে হারিয়ে যায় এবং ওই directory-তে পরবর্তী read না হওয়া পর্যন্ত ফিরে আসে না। Project root file-এর rule সবচেয়ে durable, কারণ এটি প্রতিবার disk থেকে আবার read করা হয়।

তাই কোনো instruction পুরো session জুড়ে কার্যকর থাকতেই হলে, সেটি project root file-এ কোনো paths: frontmatter ছাড়া রাখতে হবে। অন্য সব ক্ষেত্রে আপনি যে tradeoff বেছে নিচ্ছেন, তা ইচ্ছাকৃতভাবে নির্ধারণ করা উচিত। context window-এ কী থাকবে তা পরিচালনা করা-এ /compact নিয়ে একটি focus argument এবং সম্পর্কহীন task-এর মধ্যে /clear নিয়ে আলোচনা করা হয়েছে। উভয় বিষয়ই summariser কত ঘন ঘন আপনার rules-এর অর্থ নির্ধারণ করার সুযোগ পায়, তা পরিবর্তন করে।

কেন পারিপার্শ্বিক কোড নিয়মের চেয়ে বেশি কার্যকর

এটি এমন একটি ব্যর্থতা যা মানুষ সবচেয়ে বেশি বর্ণনা করে কিন্তু সবচেয়ে কম নির্ণয় করে। আপনার ফাইলে বলা আছে যে ডাটাবেস অ্যাক্সেস রিপোজিটরি লেয়ারের মাধ্যমে হতে হবে। কিন্তু এজেন্ট এমন একটি হ্যান্ডলার লেখে যা সরাসরি ORM (object relational mapper)-কে কল করে। আপনাকে স্টাইলের কারণে উপেক্ষা করা হয়নি। প্রমাণের ভিত্তিতে আপনার মতামতের চেয়ে কোডের বাস্তবতাকে প্রাধান্য দেওয়া হয়েছে।

একটি নিয়ম কেবল একটি পছন্দের বর্ণনা দেয়। আর কোড একটি বাস্তব উদাহরণ প্রদর্শন করে। যখন এজেন্ট যে মডিউলটি এডিট করতে যাচ্ছে তার তিনটি ফাইল খোলে এবং তিনটিই সরাসরি ORM-কে কল করে, তখন প্রেক্ষাপটে একদিকে একটি বিমূর্ত বাক্য থাকে এবং অন্যদিকে তিনটি সুনির্দিষ্ট, সাম্প্রতিক ও কাজের সাথে সামঞ্জস্যপূর্ণ উদাহরণ থাকে। স্থানীয় প্যাটার্ন অনুসরণ করা সাধারণত সঠিক আচরণ। এটি এখানে ভুল কারণ আপনি এমন কিছু জানেন যা প্রেক্ষাপটে নেই: ওই ফাইলগুলো লিগ্যাসি কোড।

তাই সেই তথ্যটি নিয়মের মধ্যে লিখে রাখুন। যে নিয়মগুলো তাদের নিজস্ব বিপরীত প্রমাণকে উল্লেখ করে, সেগুলো বাস্তব রিপোজিটরিতে টিকে থাকে। যে নিয়মগুলো কেবল একটি সাধারণ পছন্দ প্রকাশ করে, সেগুলো টিকে থাকে না।

নতুন ডাটাবেস অ্যাক্সেস অবশ্যই app/repositories/-এর মাধ্যমে হতে হবে। app/legacy/-এর অধীনে থাকা ফাইলগুলো এখনও সরাসরি ORM-কে কল করে। সেটি পুরনো কোড, বর্তমান প্যাটার্ন নয়। সেটি অনুসরণ করবেন না।

দ্বিতীয় বাক্যটিই মূল কাজ করে। এটি এজেন্টকে কিছু পাওয়ার আগেই জানিয়ে দেয় যে সে কী খুঁজে পাবে এবং কীভাবে তা পড়তে হবে। একই সমাধান আপনার রিপোজিটরির যেকোনো নিয়মের ক্ষেত্রে প্রযোজ্য যা কোডের সাথে সাংঘর্ষিক: যেমন এমন কোনো কমিট স্টাইল যা আপনার হিস্ট্রি অনুসরণ করে না, টেস্ট লেআউট যা আপনার টেস্ট সুইটের অর্ধেক অংশ মানে না, অথবা ইমপোর্ট কনভেনশন যা কেবল নতুন কোডেই বজায় থাকে। যেখানেই কোড ফাইলের নিয়মের সাথে দ্বিমত পোষণ করে, সেই দ্বিমতের কথা ফাইলে উল্লেখ করে দিন।

একটি অস্পষ্ট নিয়ম যাচাই করা যায় না, তাই তা অনুসরণ করাও সম্ভব নয়

"পরিচ্ছন্ন কোড লিখুন।" "অতিরিক্ত ইঞ্জিনিয়ারিং করবেন না।" "সহজ রাখুন।" "মাইগ্রেশনের সময় সতর্ক থাকুন।" এগুলোর কোনোটিই কোনো নির্দিষ্ট কাজের বিপরীতে পরীক্ষা করা সম্ভব নয়, এজেন্ট বা আপনার কারো পক্ষেই এটি করা সম্ভব নয়। কোনো এজেন্টকে এমন নিয়ম দিলে যা সে তার নিজের আউটপুটের বিপরীতে যাচাই করতে পারে না, তবে সে কেবল অনুমান করছে, আর আপনি সেই অনুমানকে আপনার অনুভূতির ভিত্তিতে মূল্যায়ন করছেন।

আপনার ফাইলের প্রতিটি লাইনের জন্য এই পরীক্ষাটি প্রয়োগ করুন। এমন একটি shell command লিখুন যা নিয়মটি ভাঙলে non-zero exit code প্রদান করবে। যদি আপনি সেই command লিখতে না পারেন, তবে নিয়মটি যাচাইযোগ্য নয়। নিচের জোড়াগুলো তুলনা করুন:

  • যাচাইযোগ্য নয়: "ফাংশন ছোট রাখুন।" যাচাইযোগ্য: "60 লাইনের চেয়ে বড় ফাংশনের উপরে কেন তা বড়, তার ব্যাখ্যাসহ একটি comment থাকতে হবে।"
  • যাচাইযোগ্য নয়: "আপনার পরিবর্তনগুলো পরীক্ষা করুন।" যাচাইযোগ্য: "npm test চালান এবং কোনো কাজ সম্পন্ন করার আগে failure count পেস্ট করুন।"
  • যাচাইযোগ্য নয়: "ফাইলগুলো গুছিয়ে রাখুন।" যাচাইযোগ্য: "HTTP handler-গুলো src/api/handlers/-এ থাকবে। অন্য কোনো ফাইল ওই ডিরেক্টরিতে রাখা যাবে না।"
  • যাচাইযোগ্য নয়: "কোড সঠিকভাবে ফরম্যাট করুন।" যাচাইযোগ্য: ".ts ফাইলগুলোতে 2 স্পেস indentation ব্যবহার করুন।"

"অতিরিক্ত ইঞ্জিনিয়ারিং করবেন না" এমন একটি নিয়ম যা মানুষ সবার আগে ছেড়ে দেয়, কারণ এর সমাধান ছোট কোনো বাক্য নয় বরং দীর্ঘ একটি ব্যাখ্যা: সবচেয়ে ছোট কার্যকর পরিবর্তন বলতে কী বোঝায় তা বিস্তারিত লেখা এজেন্টকে এমন মানদণ্ড দেয় যার বিপরীতে সে তার নিজের diff যাচাই করতে পারে।

ফাইলের আকারও একই সমস্যার ভিন্ন রূপ। Claude Code-এর নির্দেশিকা প্রতিটি instruction ফাইলের জন্য 200 লাইনের কম রাখার পরামর্শ দেয় এবং সরাসরি উল্লেখ করে যে বড় ফাইল নির্দেশ মানার হার কমিয়ে দেয়। 700 লাইনের একটি ফাইল মানেই শক্তিশালী নির্দেশনা নয়। এটি 700 লাইনের দাবি, যেখানে একে অপরের সাথে সাংঘর্ষিক হওয়ার সম্ভাবনা বেশি থাকে এবং এটি প্রতিবার আপনার window-তে চার্জ হিসেবে যুক্ত হয়, যা সরাসরি আপনার token ব্যবহারে ফুটে ওঠে। ফাইলটিকে এমনভাবে সাজানো যাতে প্রতিটি নিয়ম এমন শিরোনামের নিচে থাকে যা পাঠক দ্রুত স্ক্যান করতে পারে, তা এজেন্ট কাজ করতে পারে এমন একটি instruction ফাইল লেখা-তে আলোচনা করা হয়েছে। এর চেয়েও ভালো হয় যদি বর্ণনামূলক অংশগুলো বাদ দিয়ে নির্দেশনামূলক অংশ রাখা হয়: handler এবং model কোথায় থাকে তার একটি ডিরেক্টরি ট্যুর হলো এমন কাঠামো যা এজেন্ট repository-এর একটি parsed map থেকে প্রয়োজনে দেখে নিতে পারে, প্রতিবার window-তে বহন করার প্রয়োজন নেই।

দশ মিনিটে কীভাবে এটি নির্ণয় করবেন

নিচের কমান্ডগুলো ক্রমানুসারে চালান। শেষ ধাপে সরাসরি চলে গেলে অনেক সময় এমন একটি দীর্ঘ ফাইল তৈরি হয়, যেখানে জোর দিয়ে লেখা নিয়ম থাকলেও সেগুলো কাজ করে না।

  1. এটি লোড হয়েছে কি না নিশ্চিত করুন। /context চালিয়ে Memory files তালিকা দেখুন। Nested file-এর ক্ষেত্রে টার্মিনালে তার Loaded লাইন খুঁজুন। ফাইলটি না থাকলে অবস্থান ঠিক করুন এবং থামুন। এই তালিকার অন্য কোনো ধাপ এখনো প্রযোজ্য নয়।
  2. নতুন session-এ পুনরায় পরীক্ষা করুন। নতুন session শুরু করুন এবং নিয়মটি সক্রিয় হওয়ার কথা এমন সবচেয়ে ছোট task দিন। নতুন session-এ নিয়মটি কাজ করলেও দীর্ঘ session-এ ব্যর্থ হলে সমস্যা দূরত্ব বা compaction-এ থাকতে পারে। নতুন session-এও ব্যর্থ হলে নিয়মটিই সমস্যার কারণ।
  3. প্রতিদ্বন্দ্বী নির্দেশনা সরান। এমন একটি directory-তে একই পরিবর্তনের অনুরোধ করুন, যার বিদ্যমান code ইতিমধ্যে নিয়মটি অনুসরণ করে। compliance ফিরে এলে বুঝবেন, পারিপার্শ্বিক code আপনার বাক্যের চেয়ে বেশি প্রভাব ফেলছিল।
  4. বিরোধ খুঁজুন। একই আচরণ সম্পর্কে দুটি file-এ ভিন্ন নির্দেশনা থাকলে সেটিই নথিভুক্ত ব্যর্থতার কারণ। model যেকোনো একটি নির্দেশনা বেছে নিতে পারে, এবং তা যে এমন করেছে সেটি আপনাকে জানাবে না।
  5. নিয়মটি যাচাইযোগ্য করুন এবং আবার পরীক্ষা করুন। নির্দিষ্ট path ও condition ব্যবহার করে নিয়মটি পুনর্লিখুন। compliance উল্লেখযোগ্যভাবে বেড়ে গেলে বুঝবেন, বাক্যবিন্যাসই সমস্যার কারণ ছিল।

Step 4-এর জন্য একটি কমান্ডই যথেষ্ট। শুধু যে file-টি সম্পাদনা করছিলেন সেটি নয়, বিষয়টি সম্পর্কে প্রতিটি instruction source-এ Grep চালান:

grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/null

দুটি file-এ পরস্পরবিরোধী নির্দেশনা পাওয়া গেলে সেটিই আপনার bug। একটি মুছে দিন। আরও শক্তিশালী ভাষা ব্যবহার করে নির্দেশনাগুলোর অগ্রাধিকার নির্ধারণের চেষ্টা করবেন না, কারণ এর জন্য কোনো ranking engine নেই। Claude Code v2.1.283 বা পরবর্তী সংস্করণে /doctor prompt-audit আপনার instruction files, rules এবং skills জুড়ে এই search-এর আরও বিস্তৃত সংস্করণ চালায় এবং প্রস্তাবিত edit-সহ বিরোধগুলো জানায়। আপনি অনুরোধ না করা পর্যন্ত এটি কোনো কিছু পরিবর্তন করে না।

প্রভাবের ক্রমানুসারে সমাধান

নিচের প্রতিটি ধাপ তার ওপরের ধাপের চেয়ে বেশি কার্যকর, তবে সেটআপ করতেও বেশি সময় লাগে। কোনো নিয়মের ভাষা সহজে পরিবর্তন করা গেলে ওপরের ধাপ থেকে শুরু করুন। কোনো নিয়ম এত গুরুত্বপূর্ণ হয়ে উঠলে যে মাঝে মাঝে বাদ পড়া গ্রহণযোগ্য নয়, তখন নিচের ধাপে যান।

  1. নিয়মটি নির্দিষ্ট করুন। কোনো path, command বা condition উল্লেখ করুন। আগে দেখানো পদ্ধতিতে repository-তে agent যে বিপরীত প্রমাণ খুঁজে পাবে, সেটিও যোগ করুন। এতে কোনো অতিরিক্ত খরচ নেই এবং আশ্চর্যজনকভাবে অনেক সমস্যার সমাধান হয়।
  2. নিয়মটি যে বিষয় নিয়ন্ত্রণ করে, তার কাছাকাছি রাখুন। একটি nested CLAUDE.md, .claude/rules/-এ path-scoped rule, অথবা file-এর একেবারে শুরুতে একটি comment ব্যবহার করুন। তাহলে নিয়মটি যে code-এর ওপর প্রযোজ্য, সেটি পড়ার সময়ই নিয়মটি উপস্থিত থাকে। এর বিনিময়টি মেনে নিন: এভাবে load করা যেকোনো বিষয় পরবর্তী compaction-এ বাদ পড়বে এবং পরবর্তী matching read-এ আবার ফিরে আসবে।
  3. Enforcement-কে hook-এ সরিয়ে নিন। Prose অনুরোধ করে। Hook সিদ্ধান্ত নেয়। Hook নির্দিষ্ট lifecycle event-এ code হিসেবে চলে এবং model যা-ই সিদ্ধান্ত নিক না কেন, তা প্রয়োগ করে।
  4. নিয়মটি deterministic tool-এর ওপর ন্যস্ত করে prose মুছে ফেলুন। Formatting, import order, line length, নিষিদ্ধ import এবং commit message-এর format। ruff format, prettier --write, eslint, অথবা একটি pre-commit hook ব্যবহার করুন। Formatter প্রতিবার সঠিক ফল দেয় এবং কোনো token খরচ করে না। বাক্যটি অধিকাংশ সময় সঠিক থাকে, কিন্তু প্রতিটি turn-এ token খরচ করে।

ধাপ 3 বিস্তারিতভাবে দেখা যাক। ধরুন, agent কখনো migration file সম্পাদনা করতে পারবে না। .claude/settings.json-এ এটি রাখুন:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
          }
        ]
      }
    ]
  }
}

এবং .claude/hooks/guard-migrations.sh-এ এটি রাখুন:

#!/usr/bin/env bash
set -euo pipefail

path=$(jq -r '.tool_input.file_path // empty')

case "$path" in
  */migrations/*)
    echo "Files under migrations/ are written by hand. Stop and ask first." >&2
    exit 2
    ;;
esac

exit 0

chmod +x .claude/hooks/guard-migrations.sh চালান। এরপর একটি নতুন session শুরু করে agent-কে migrations/-এর অধীনে থাকা একটি file সম্পাদনা করতে বলুন। সম্পাদনা প্রত্যাখ্যান করা হবে এবং আপনার message-ই কারণ হিসেবে ফেরত আসবে। PreToolUse-এ exit status 2 tool call চালানোর আগেই সেটিকে আটকে দেয়, আর আপনার stderr text blocking message হিসেবে model-এর কাছে পাঠানো হয়। ${CLAUDE_PROJECT_DIR} project root-এ resolve হয়, তাই agent যে directory-তেই থাকুক, hook কাজ করে। Agent-কে নিয়মটির সঙ্গে একমত হতে হবে না, নিয়মটি মনে রাখতে হবে না, এমনকি নিয়মটি context-এ থাকতেও হবে না। সম্পাদনা হবে না।

কোনো logic ছাড়া সরল prohibition-এর ক্ষেত্রে settings-এ permissions.deny একই কাজ করে, তবে maintain করার মতো কোনো script লাগে না। permission mode নির্ধারণ করে কোন কাজ আপনার আগে জিজ্ঞাসা না করেই চলবে। কোনো নির্দেশনা সত্যিই user message-এর পরিবর্তে system prompt level-এ রাখতে হলে --append-system-prompt সেটি সেখানে রাখে। তবে এটি একটি launch flag, যা প্রতিটি নতুন session-এ আবার pass করতে হয়। তাই interactive কাজের চেয়ে script-এর জন্য এটি বেশি উপযোগী।

যা আপনি নির্দেশ দিয়ে নিয়ন্ত্রণ করতে পারবেন না

কোন অংশটি আপনার এবং কোন অংশটি মডেলের, তা পরিষ্কার রাখুন। প্লেসমেন্ট, শব্দচয়ন, ফাইলের মধ্যে দ্বন্দ্ব এবং ফাইলের আকার—এগুলো লেখকের সমস্যা এবং লেখককেই তা সমাধান করতে হবে। বাকি অংশগুলো মডেলের আচরণগত বৈশিষ্ট্য, যা কেবল ভালো শব্দ ব্যবহার করে দূর করা সম্ভব নয়।

সম্মতি মানেই নিয়ম মেনে চলা নয়। একটি এজেন্ট কোনো নিয়ম স্বীকার করবে, তা আপনাকে সঠিকভাবে পুনরায় বলবে এবং দুই ধাপ পরেই তা ভেঙে ফেলবে। এই স্বীকারোক্তির কোনো মূল্য নেই এবং এটি কোনো কিছুর পূর্বাভাস দেয় না। একে সমাধান হিসেবে দেখবেন না এবং একে কোনো পরীক্ষার ফলাফল হিসেবে গণ্য করবেন না।

কিছু অভ্যাস স্থায়ী হয়। মন্তব্য যোগ করা, ডিফেন্সিভ এরর হ্যান্ডলিং যোগ করা, শেষে সারসংক্ষেপ লেখা, পরবর্তী স্পষ্ট কমান্ডটি চালানো—এগুলো নিয়ম দ্বারা নিষিদ্ধ করার পরেও ফিরে আসে, তবে হার কিছুটা কমে। আপনি নিজেই এই হার পরিমাপ করতে পারেন: নতুন সেশনে একই কাজ দশবার চালান এবং কতবার নিয়ম লঙ্ঘন হয়েছে তা গণনা করুন। যেখানে এই সংখ্যা শূন্য হওয়া প্রয়োজন, সেখানে নিয়মটি প্রম্পট থেকে সরিয়ে ফেলতে হবে। কাজ শেষ না হওয়া সত্ত্বেও শেষ হয়েছে বলে দাবি করা একই ধরনের অভ্যাস। এর সমাধান মৌখিক নয়, বরং কাঠামোগত: the unlazy skill trades the sentence for a Depth Tree and gate files the agent has to clear before it may claim done।

আপনার নিজের সেশনটিই একটি উদাহরণ হয়ে ওঠে। যদি এজেন্ট 12 নম্বর ধাপে নিয়ম ভাঙে এবং আপনি তা এড়িয়ে যান, তবে সেই লঙ্ঘনটি কনটেক্সটে একটি উদাহরণ হিসেবে থেকে যায় এবং এটি নিয়মের চেয়েও সাম্প্রতিক। কোনো লঙ্ঘন দেখার সাথে সাথেই তা সংশোধন করুন। একটি অসংশোধিত লঙ্ঘন পুরো সেশনকে ভুল শিক্ষা দেয়।

একটি ইনস্ট্রাকশন ফাইল কোনো নিরাপত্তা সীমানা নয়। এটি আচরণকে রূপ দেয় কিন্তু তা কার্যকর করে না। যেখানে ভুল হওয়া ব্যয়বহুল, যেমন ক্রেডেনশিয়াল বা ধ্বংসাত্মক কমান্ড, তা পারমিশন বা হুকের মাধ্যমে নিয়ন্ত্রণ করা উচিত। Keeping secrets out of reach of an agent ডেটার ক্ষেত্রেও একই নীতি প্রয়োগ করে: এজেন্টকে কোনো ফাইল না পড়ার অনুরোধ না করে, ফাইলটি যাতে পড়ার যোগ্য না হয় তার ব্যবস্থা করুন।

সংক্ষেপে: ফাইলটি লোড হয়েছে তা প্রমাণ করুন, নিয়মটিকে যাচাইযোগ্য করুন, যে বিষয়টিকে নিয়ন্ত্রণ করতে চান তার পাশেই নিয়মটি রাখুন। যখন ভুলের হার গুরুত্বপূর্ণ হয়ে দাঁড়ায়, তখন তা গদ্য থেকে সরিয়ে ফেলুন। যে নিয়ম এজেন্ট উপেক্ষা করতে পারে না, তা এমন একটি নিয়ম যা এজেন্টকে কখনো অনুরোধই করা হয়নি।

FAQ

Claude Code আমার CLAUDE.md উপেক্ষা করছে কেন?

উপেক্ষা করা হয়েছে ধরে নেওয়ার আগে ফাইলটি লোড হয়েছে কি না যাচাই করুন। /context চালিয়ে Memory files তালিকা দেখুন; সেখানে যে ফাইলের নাম নেই, সেটি চালুর সময় লোড হয়নি। Instruction file-গুলো system prompt-এর পরে user message হিসেবে পাঠানো হয় এবং বাধ্যতামূলক configuration-এর বদলে context হিসেবে বিবেচিত হয়। তাই কঠোরভাবে মেনে চলার নিশ্চয়তা নেই। বাস্তবে বেশিরভাগ ক্ষেত্রে চারটির একটি ঘটে: ফাইলটি এমন subdirectory-তে আছে যেখান থেকে agent কখনও পড়েনি, দুটি ফাইলে পরস্পরবিরোধী নির্দেশ আছে এবং model ইচ্ছামতো একটি বেছে নিয়েছে, নিয়মটি এত অস্পষ্ট যে কোনো action-এর সঙ্গে মিলিয়ে যাচাই করা যায় না, অথবা আশপাশের code নিয়মটির বিপরীত আচরণ দেখায়।

Session চলাকালে instruction file সম্পাদনা করলে কি কিছু পরিবর্তন হয়?

কথোপকথনে ইতিমধ্যে থাকা copy-টির ক্ষেত্রে নয়। আপনার working directory-এর ওপরের file-গুলো launch-এর সময় সম্পূর্ণ লোড হয়। তাই model যে text ধরে রাখে, সেটি launch-এর সময়কার text। সম্পাদিত version নিতে নতুন session শুরু করুন। অথবা agent-কে তার স্বাভাবিক file tools দিয়ে file পড়তে বলুন। এতে বর্তমান version নতুন message হিসেবে কথোপকথনে যুক্ত হবে। Compaction-এর পরে project root file disk থেকে আবার পড়া হয়। তাই সেই সময় নতুন version-ও যুক্ত হয়।

Root CLAUDE.md এবং nested CLAUDE.md-এর মধ্যে মতবিরোধ হলে কোন file কার্যকর হয়?

কোনোটিই নির্ভরযোগ্যভাবে নয়। আবিষ্কৃত file-গুলো একে অপরকে override না করে context-এ একত্র করা হয়। এগুলো filesystem root থেকে আপনার working directory পর্যন্ত ক্রমানুসারে সাজানো হয়। তাই সবচেয়ে কাছের file-টি কেবল সর্বশেষে পড়া হয়। মতবিরোধ সমাধানের কোনো precedence engine নেই। Claude Code-এর documentation-এও বলা হয়েছে, পরস্পরবিরোধী নিয়ম ইচ্ছামতো সমাধান হতে পারে। Nested file-গুলোতে শুধু সংযোজন লিখুন এবং কোন path-এর ওপর তা প্রযোজ্য তা উল্লেখ করুন। কোনো নিয়মকে অন্যটির চেয়ে অগ্রাধিকার দেওয়ার চেষ্টা না করে মতবিরোধটি মুছে ফেলুন।

/compact চালানোর পর কি আমার instruction টিকে থাকে?

কীভাবে instruction-টি লোড হয়েছিল, তার ওপর নির্ভর করে। Project root CLAUDE.md, unscoped rule এবং auto memory compaction-এর পরে disk থেকে আবার যুক্ত হয়। paths: frontmatter-যুক্ত rule এবং subdirectory-র nested CLAUDE.md file আবার সংশ্লিষ্ট file পড়া না হওয়া পর্যন্ত হারিয়ে যায়। Chat-এ শুধু টাইপ করা কোনো বিষয় summariser রেখে দিলে তবেই টিকে থাকে। কোনো নিয়মকে পুরো session জুড়ে কার্যকর রাখতে হলে project root file-এ সেটি রাখুন এবং কোনো paths: frontmatter ব্যবহার করবেন না।

কখন কোনো নিয়ম prose না হয়ে hook হওয়া উচিত?

যখন check-টি deterministic এবং miss হওয়ার ক্ষতি একটি ছোট script লেখার খরচের চেয়ে বেশি। File path restriction, commit-এর আগে প্রয়োজনীয় command এবং নিষিদ্ধ tool call—সবই এর আওতায় পড়ে। একটি PreToolUse hook status 2 দিয়ে বের হলে tool call সরাসরি আটকে যায় এবং আপনার stderr text-কে কারণ হিসেবে model-এর কাছে পাঠায়। ফলে নিয়মটি context-এ আর থাকুক বা না থাকুক, তা কার্যকর থাকে। Formatter বা linter যে সিদ্ধান্ত নিতে পারে, সেই কাজটি সংশ্লিষ্ট tool-এর ওপর ছেড়ে দিন এবং instruction file থেকে সম্পূর্ণ মুছে ফেলুন।

এই লেখাটি কি কাজে লেগেছে?