সীমাবদ্ধতা

Somtum প্রোডাকশন-রেডি, কিন্তু এটিতে কিছু বাস্তব ট্রেড-অফ আছে যা প্রতিশ্রুতি দেওয়ার আগে জানা ভালো। এই পৃষ্ঠাটি কভার করে এটি কোথায় ভালো কাজ করে না — এবং প্রতিটি ক্ষেত্রে কী করতে হবে।

---

মান দীর্ঘমেয়াদী প্রজেক্টে বেশি

সমস্যা: ~২০-এরও কম মেমরি সহ একটি নতুন প্রজেক্টে, somtum stats প্রায়ই ১.৫×-এর নিচে breakeven ratio দেখাবে। ইনজেকশনের টোকেন খরচ (প্রতিটি প্রম্পটে মেমরি পড়া এবং পাঠানো) মেমরি স্টোর যথেষ্ট বড় না হওয়া পর্যন্ত সাশ্রয়ের চেয়ে বেশি হতে পারে।

কী আশা করবেন: সপ্তাহের পর সপ্তাহ মেমরি জমা হওয়া এবং আরও বেশি বার রিট্রিভ হওয়ার সাথে সাথে ratio স্বাভাবিকভাবে উন্নত হয়। এক মাস ধরে কাজ করা ৫০+ মেমরির একটি প্রজেক্ট ধারাবাহিক সাশ্রয় দেখবে।

কী করবেন:

• নতুন প্রজেক্টে somtum doctor breakeven সম্পর্কে সতর্ক করলে আতঙ্কিত হবেন না — এটি প্রত্যাশিত।
• ওভারহেড কমাতে প্রাথমিক পর্যায়ের প্রজেক্টে injection.k কমিয়ে 1 বা 2 করুন।
• এক মাস পরে somtum stats রান করুন এবং তুলনা করুন।

---

BM25 অর্থগতভাবে মিল মেমরি খুঁজে পায় না

সমস্যা: ডিফল্ট রিট্রিভাল কৌশল হল BM25 — SQLite FTS5-এ কীওয়ার্ড ম্যাচিং। এটি দ্রুত এবং অফলাইনে কাজ করে, কিন্তু এটি সম্পূর্ণ lexical। "Jest থেকে Vitest-এ মাইগ্রেট করেছি" শিরোনামের একটি মেমরি পাওয়া যাবে না যখন আপনি জিজ্ঞেস করবেন "কেন আমরা test runner পরিবর্তন করলাম?" কারণ কোনো শব্দ মিলছে না।

কী করবেন:

হাইব্রিড রিট্রিভাল সক্ষম করুন (BM25 + embeddings + Haiku rerank):

somtum config set retrieval.embeddings.enabled true
somtum reindex   # একবার ~৩০ MB ONNX মডেল ডাউনলোড করে
somtum config set retrieval.strategy hybrid

মডেল ডাউনলোড না চাইলে, index কৌশল Haiku ব্যবহার করে মেমরি ক্যাটালগ পড়তে এবং প্রাসঙ্গিক ID বাছাই করতে:

somtum config set retrieval.strategy index

হাইব্রিডের জন্য embeddings সক্ষম করা প্রয়োজন

embeddings সক্ষম না করে strategy=hybrid সেট করলে hybrid ওভারহেড পে করার সময় চুপচাপ BM25-এ ফলব্যাক হয়। এটি ধরতে somtum doctor রান করুন।

---

এক্সট্র্যাকশনের মান সেশনের বিষয়বস্তুর উপর নির্ভর করে

সমস্যা: এক্সট্র্যাক্টর শুধুমাত্র টেকসই পর্যবেক্ষণ রাখে — সিদ্ধান্ত, বাগ ফিক্স, শিক্ষা, গুরুত্বপূর্ণ কমান্ড। এমন একটি সেশন যেখানে আপনি Claude-কে কোনো কনসেপ্ট ব্যাখ্যা করতে বললেন, কিছু boilerplate লিখলেন, বা একটি সংক্ষিপ্ত কথোপকথন করলেন, সেটি সঠিকভাবে ০ পর্যবেক্ষণ ফেরত দেবে।

কী করবেন:

• ~/.somtum/hook.log চেক করুন — যদি inserted=0 দেখায়, সেশনটি সম্ভবত এক্সট্র্যাক্ট করার মতো যথেষ্ট গভীর ছিল না।
• যা সংরক্ষণ করতে চান তার জন্য MCP টুল বা CLI-এর মাধ্যমে somtum remember ব্যবহার করুন।
• আর্কিটেকচার সিদ্ধান্ত, ডিবাগিং সেশন, বা উল্লেখযোগ্য রিফ্যাক্টরিং কভার করে এমন সেশনগুলিতে স্বয়ংক্রিয় এক্সট্র্যাকশন সবচেয়ে ভালো কাজ করে।

---

Windows-এ পরীক্ষা সীমিত

সমস্যা: Somtum-এর হুক পাইপলাইন মূলত macOS এবং Linux-এ পরীক্ষিত। Windows-এ পাথ হ্যান্ডলিং, শেল এনভায়রনমেন্ট ইনহেরিটেন্স, এবং better-sqlite3 নেটিভ বিল্ড পুরোপুরি যাচাই হয়নি।

পরিচিত সমস্যা:

• কিছু Windows সেটআপে better-sqlite3-এর জন্য windows-build-tools প্রয়োজন হতে পারে।
• ANTHROPIC_API_KEY-এর জন্য শেল প্রোফাইল ইনহেরিটেন্স Unix-এর চেয়ে Windows-এ আলাদাভাবে কাজ করে।

কী করবেন: Windows-এ সমস্যা হলে WSL2 ব্যবহার করুন — Windows ডেভেলপারদের জন্য এটি সমর্থিত পথ।

---

Somtum CLAUDE.md পরিপূরক — প্রতিস্থাপন নয়

সমস্যা: Somtum সেশন থেকে জমানো অভিজ্ঞতা ক্যাপচার করে। CLAUDE.md হল লেখক-নির্দেশিত উদ্দেশ্য — এমন জিনিস যা আপনি চান Claude সবসময় জানুক।

শুধুমাত্র Somtum-এর উপর নির্ভর করে Claude-কে গুরুত্বপূর্ণ প্রজেক্ট নিয়মগুলি সম্পর্কে অবহিত রাখা ঝুঁকিপূর্ণ। Somtum বর্তমান প্রম্পটের প্রাসঙ্গিকতার ভিত্তিতে রিট্রিভ করে; BM25 query-তে ম্যাচ না হওয়া একটি নিয়ম ইনজেক্ট হবে না।

কী করবেন:

• Somtum থেকে উচ্চ-সংকেত পর্যবেক্ষণগুলি CLAUDE.md-তে প্রমোট করতে somtum suggest-claude-md ব্যবহার করুন।
• স্থায়ী নিয়মগুলি CLAUDE.md-এ রাখুন — টিম কনভেনশন, আর্কিটেকচার সীমাবদ্ধতা।
• অতীতের বাগ, নির্দিষ্ট সিদ্ধান্ত, এককালীন শিক্ষার জন্য Somtum রেখে দিন।

---

মাঝে মাঝে ছাঁটাই ছাড়া মেমরি বাড়তে থাকে

সমস্যা: ডিডুপ্লিকেশন (M10) সেশন থেকে সেশনে কাছাকাছি-ডুপ্লিকেট পর্যবেক্ষণ পরিচালনা করে। কিন্তু এটি এমন মেমরি সরাতে পারে না যা আর প্রাসঙ্গিক নয় — একটি ফাইল যা আপনি মুছেছেন, একটি লাইব্রেরি যা প্রতিস্থাপিত হয়েছে, একটি সিদ্ধান্ত যা বাতিল হয়েছে।

কী করবেন:

# সিদ্ধান্ত নেওয়ার আগে পুরনো বিষয় সম্পর্কে Somtum কী মনে রাখে তা দেখুন
somtum search "পুরনো লাইব্রেরির নাম"

# নির্দিষ্ট এন্ট্রি soft-delete করুন
somtum forget <id>

# Doctor ৯০ দিনের বেশি পুরনো কোনো রিট্রিভাল ছাড়া মেমরি সম্পর্কে সতর্ক করে
somtum doctor

# ৬০ দিনের বেশি পুরনো soft-deleted এন্ট্রি hard-remove করুন
somtum purge --older-than 60d

দীর্ঘমেয়াদী প্রজেক্টে মাসিক pruning pass বিবেচনা করুন।

---

এক্সট্র্যাকশনের খরচ বাস্তব

সমস্যা: প্রতিটি সেশন শেষে পর্যবেক্ষণ এক্সট্র্যাক্ট করতে একটি Claude Haiku কল ট্রিগার হয়। Anthropic API-তে এটি একটি বাস্তব খরচ।

কী করবেন:

• Claude Code সাবস্ক্রিপশনে থাকলে ANTHROPIC_API_KEY আনসেট রাখুন এবং claude CLI ফলব্যাক ব্যবহার করুন — এক্সট্র্যাকশন তখন API ক্রেডিটের পরিবর্তে আপনার সাবস্ক্রিপশন কোটা ব্যবহার করে।
• প্রতি সেশনে খুব বেশি নিম্নমানের পর্যবেক্ষণ তৈরি হলে extraction.max_observations_per_session কমান।
• সঞ্চয় ব্যয়কে ছাড়িয়ে যাচ্ছে কিনা তা নিয়মিত পরীক্ষা করতে somtum stats রান করুন।