Fable Orchestrator দিয়ে রাউটেড কোডিং ওয়ার্কফ্লো তৈরি করুন

Fable কী করে

Fable হলো Codex-এর জন্য একটি ছোট, local-first রাউটিং স্কিল। এটি পরিকল্পনা ও বাস্তবায়নকে আলাদা করে: Claude Fable 5.1 কাজের পরিকল্পনা করে এবং সিদ্ধান্তে মীমাংসা করে, আর Codex runtime হিসেবে থাকে, workspace নিয়ন্ত্রণ করে এবং সীমাবদ্ধ বাস্তবায়ন-সংক্রান্ত কাজ OpenCode Go এজেন্টদের কাছে অর্পণ করে।

সাধারণ বাস্তবায়নের কাজ GPT-5.6 Luna-কে দেওয়া হয়। লুপ, বারবার iteration, বা উচ্চ-থ্রুপুট বাস্তবায়ন-সংক্রান্ত কাজ DeepSeek V4 Flash-কে দেওয়া হয়। Claude Fable 5.1 বাস্তবায়ন গ্রাফের বাইরে থাকে এবং কোড লেখে না বা workspace-এর মালিকানা রাখে না।

Fable একটি orchestration skill, স্বতন্ত্র model gateway বা development dashboard নয়।

প্রধান বৈশিষ্ট্য

• Local-first কার্যক্রম: স্কিলটি একটি স্থানীয় Codex skills directory-তে ইনস্টল করা হয়।
• স্পষ্ট ভূমিকা বিভাজন: Fable পরিকল্পনা করে ও মীমাংসা করে, আর Codex কাজ সম্পাদন ও যাচাই করে।
• সীমাবদ্ধ delegation: বাস্তবায়ন নোডগুলো কেবল অনুমোদিত GPT-5.6 Luna বা DeepSeek V4 Flash route ব্যবহার করে।
• সমান্তরাল execution: উপযোগী হলে Codex প্রস্তুত worker-গুলোকে সমান্তরালে চালু করতে পারে।
• প্রমাণভিত্তিক verification: workflow সম্পন্ন করার আগে Codex worker-দের প্রমাণ সংগ্রহ করে এবং ফলাফল যাচাই করে।
• Fail-safe routing: অনুমোদিত OpenCode Go route দুটির কোনোটিই callable না হলে, workflow অননুমোদিত model ব্যবহার না করে blocker-এর প্রতিবেদন করে।
• নিরাপদ, পুনরাবৃত্তিযোগ্য installation: installer dry run, custom target এবং idempotent copying সমর্থন করে।

Repository বুঝে নিন

Repository-তে installable skill, installer, tests এবং একটি architecture asset রয়েছে:

skill/fable/\n├── SKILL.md\n├── agents/openai.yaml\n└── scripts/ask_fable.sh\nassets/fable-orchestrator.svg\ninstall.sh\ntests/test_skill.sh

skill/fable/-এর ভেতরের তিনটি ফাইল installable skill গঠন করে। ask_fable.sh script-টি executable এবং session persistence ছাড়াই Claude Code-এর স্থানীয় fable alias-কে কল করে।

পূর্বশর্ত

স্কিলটি ইনস্টল করার আগে Codex Router-এর মাধ্যমে callable opencode-go/ এবং opencode-go-responses/ agent কনফিগার করুন। Fable এই agent-গুলো ব্যবহার করে, কিন্তু নিজস্ব proxy, dashboard, model catalog, credential store বা API key সরবরাহ করে না।

Provider বা agent definition পরিবর্তন করার পর Codex পুনরায় চালু করুন। এতে নতুন task বর্তমান routing configuration দেখতে পাবে।

Fable ইনস্টল করুন

১. Installation preview করুন

Repository root থেকে installer-কে dry-run mode-এ চালান:

./install.sh --dry-run

এটি কোনো ফাইল তৈরি না করে সঠিক destination এবং copy operation প্রিন্ট করে। পরিবর্তন করার আগে installer কী করবে তা নিশ্চিত করতে এটি ব্যবহার করুন।

২. Default directory-তে ইনস্টল করুন

Skill-টি default Codex skills location-এ কপি করুন:

./install.sh --copy

Default destination হলো ~/.codex/skills/fable। Installer কেবল প্রয়োজনীয় directory তৈরি করে এবং বারবার চালানো নিরাপদ।

৩. Custom skills directory নির্বাচন করুন

Default location-এর পরিবর্তে অন্য কোথাও ইনস্টল করতে চাইলে --target ব্যবহার করুন:

./install.sh --copy --target "$PWD/.local/codex/skills"

Installer কেবল repository এবং destination path পড়ে। এটি credentials পড়ে না, তৈরি করে না বা পরিবর্তন করে না।

মৌলিক ব্যবহার

একটি নতুন Codex task শুরু করুন, তারপর একটি objective-সহ skill-টি invoke করুন:

$fable build the feature

Fable একটি সীমাবদ্ধ work graph দিয়ে সাড়া দেয়। Codex সেই graph যাচাই করে, উপযুক্ত হলে প্রস্তুত worker-গুলোকে সমান্তরালে চালু করে, তাদের প্রমাণ সংগ্রহ করে এবং ফলস্বরূপ কাজ যাচাই করে। আরেকটি planning decision প্রয়োজন হলে Codex Fable-কে মীমাংসার জন্য অনুরোধ করে।

Routing কীভাবে কাজ করে

1. Fable objective বিশ্লেষণ করে এবং একটি সীমাবদ্ধ plan তৈরি করে।
2. Execution-এর আগে Codex প্রস্তাবিত graph যাচাই করে।
3. সাধারণ implementation node-গুলো GPT-5.6 Luna-তে route করা হয়।
4. Iteration-heavy বা high-throughput implementation node-গুলো DeepSeek V4 Flash-এ route করা হয়।
5. Codex প্রমাণ সংগ্রহ করে এবং চূড়ান্ত ফলাফল যাচাই করে।
6. আরও adjudication প্রয়োজন হলে Fable-কে আবার পরামর্শ করা হয়।

প্রতিটি implementation node-কে অবশ্যই অনুমোদিত দুটি OpenCode Go route-এর একটিকে ব্যবহার করতে হবে। কোনোটিই উপলভ্য না হলে routing policy পাশ কাটানোর চেষ্টা না করে প্রতিবেদিত blocker-কে configuration issue হিসেবে বিবেচনা করুন।

Planning Packet নিরাপদে পরিচালনা করুন

ask_fable.sh-এ পাঠানো packet-এ কেবল decision এবং workspace facts থাকা উচিত। Packet-এ কখনো credentials, API key, token বা অন্য কোনো secret অন্তর্ভুক্ত করবেন না।

Script-টি session persistence ছাড়াই স্থানীয় fable alias-কে কল করে। তাই প্রতিটি request-এ সংশ্লিষ্ট planning বা adjudication step-এর জন্য প্রয়োজনীয় তথ্য অন্তর্ভুক্ত করা উচিত।

Installation পরীক্ষা করুন

Repository root থেকে repository-র dependency-light test suite চালান:

tests/test_skill.sh

Test-এ যা যাচাই করা হয়:

• Shell syntax।
• Installer যে source file-গুলো কপি করে।
• প্রয়োজনীয় routing string।
• মৌলিক YAML structure।
• xmllint-এর মাধ্যমে ঐচ্ছিক XML validation।
• SVG safety constraint।
• Temporary home directory ব্যবহার করে একটি dry run।
• একটি idempotent copy operation।
• সাধারণ credential-সদৃশ string-এর উপস্থিতি।

Test চালাতে PyYAML বা সক্রিয় Claude login প্রয়োজন হয় না, তাই এটি হালকা স্থানীয় validation-এর জন্য উপযোগী।

উন্নত পরিচালনাগত পরামর্শ

Skill debug করার আগে routing যাচাই করুন

Fable যদি জানায় যে কোনো অনুমোদিত implementation route কল করা যাচ্ছে না, তাহলে প্রথমে opencode-go/ এবং opencode-go-responses/-এর জন্য Codex Router-এর সংজ্ঞাগুলো পরীক্ষা করুন। provider বা agent-এর সংজ্ঞা পরিবর্তন করার পর Codex পুনরায় চালু করে একটি নতুন task শুরু করুন।

কাস্টম deployment-এর জন্য dry run ব্যবহার করুন

কোনো project-local বা nonstandard skills directory-তে ইনস্টল করার সময় কপি করার আগে --dry-run-এর সঙ্গে --target ব্যবহার করুন:

./install.sh --dry-run --target "$PWD/.local/codex/skills"
./install.sh --copy --target "$PWD/.local/codex/skills"

এর মাধ্যমে নির্বাচিত directory পরিবর্তন করার আগে গন্তব্য এবং পরিকল্পিত file operation-গুলো পরিদর্শন করা যায়।

আপডেট করার সময় ইনস্টলেশন পুনরায় চালান

কপি operation-টি idempotent হওয়ায় repository থেকে ইনস্টল করা skill refresh করার সময় এটি নিরাপদে আবার চালাতে পারেন। Repository check-গুলো যাচাই করতে কপির পর tests/test_skill.sh চালান।

দায়িত্ব আলাদা রাখুন

Fable-কে implementation worker হিসেবে বিবেচনা করবেন না। নথিভুক্ত দায়িত্ব হলো planning এবং final adjudication। Runtime control, workspace ownership, delegation, evidence collection এবং verification Codex-এর কাছেই থাকে।

উপসংহার

Codex-এ সীমাবদ্ধ planning এবং model routing যোগ করার জন্য Fable একটি কেন্দ্রীভূত পদ্ধতি প্রদান করে। OpenCode Go agent-গুলো কনফিগার করুন, skill-এর preview দেখুন ও কপি করুন, স্পষ্ট objective দিয়ে এটি invoke করুন এবং setup যাচাই করতে অন্তর্ভুক্ত test-গুলো ব্যবহার করুন। Planning packet-এ credential রাখবেন না এবং routing definition পরিবর্তন হলে Codex পুনরায় চালু করুন।