Claude Code কীভাবে সব সাজায় — ফোল্ডার, ফাইল, প্রজেক্ট (বাংলা টিউটোরিয়াল)

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

আজকের পুরো লেখায় আমরা একেবারে বাংলায় দেখব, Claude Code কীভাবে ফোল্ডার, ফাইল এবং প্রজেক্ট ম্যানেজমেন্টের কাজটা করে। সাথে থাকবে ব্যবহারিক উদাহরণ, বেস্ট প্র্যাকটিস আর কিছু টিপস যা আপনাকে একজন দক্ষ Claude Code ব্যবহারকারী বানাবে।

Claude Code হচ্ছে অ্যানথ্রোপিকের Claude AI-র একটি এজেন্টিক কোডিং টুল। সরাসরি আপনার টার্মিনালে বসে, আপনার পুরো প্রজেক্টের ফাইল স্ট্রাকচার বোঝে এবং চাহিদা অনুযায়ী ফোল্ডার ও ফাইল গোছানো থেকে শুরু করে ফাংশন রাইটিং, রিফ্যাক্টরিং, টেস্টিং — সবই করে। Claude Code-কে আপনি বলতে পারেন আপনার কোডবেসের একজন অটোমেটেড আর্কিটেক্ট।

অন্য অনেক AI টুলের সাথে Claude Code-এর মূল পার্থক্য হচ্ছে — এটি আপনার পুরো প্রজেক্টটাকে “দেখতে” পারে। ফাইল ট্রি বুঝতে পারে, ডিরেক্টরির কাঠামো অ্যানালাইজ করতে পারে এবং সেই অনুযায়ী কোন ফাইল কোথায় রাখলে লজিক্যালি ও স্কেলেবল হবে তা সাজেস্ট বা নিজেই ইমপ্লিমেন্ট করতে পারে। এর জন্য Claude Code-কে শুধু পারমিশন দিন আর গাইড করে বলুন আপনি কী চান।

একটা বড় প্রজেক্টে ফোল্ডার স্ট্রাকচার যতটা না টেকনিক্যাল ব্যাপার, তার চেয়ে বেশি ডিসিপ্লিনের বিষয়। যেকোনো মিড-লেভেল ডেভেলপার জানে, “কম্পোনেন্টস” ফোল্ডারে কম্পোনেন্ট, “ইউটিলস”-এ হেল্পার ফাংশন আর “পেজেস”-এ পেজ থাকবে — কিন্তু কাজের চাপে প্রায়ই দেখা যায় সব গুলিয়ে একটা “স্রোত” ফোল্ডারে দশটা ফাইল ছুড়ে ফেলা হয়। এখানেই Claude Code জাদু দেখায়।

Claude Code যখনই কোনও নতুন ফিচার অ্যাড করে বা রিফ্যাক্টর করে, সে আপনার প্রজেক্টের বিদ্যমান কনভেনশন ফলো করে। যদি সে দেখে আপনি src/components ইউজ করছেন, তাহলে নতুন কম্পোনেন্ট সেখানেই রাখবে। যদি দেখে আপনি ফিচার-বেসড স্ট্রাকচার (যেমন features/auth/) ইউজ করছেন, তাহলে সেই ধাঁচেই ফোল্ডার আর ফাইল ক্রিয়েট করবে। এমনকি যখন আপনার প্রজেক্টের কোনও নির্দিষ্ট কনভেনশন না থাকে, Claude Code নিজে থেকেই ইন্ডাস্ট্রি স্ট্যান্ডার্ড মেনে একটা লজিক্যাল স্ট্রাকচার প্রস্তাব করে এবং আপনার সম্মতি নিয়ে কাজ করে।

ধরুন, আপনি Claude Code-কে বললেন, “আমার প্রজেক্টে একটা অথেন্টিকেশন ফিচার অ্যাড করো।” Claude Code শুধু অথেন্টিকেশন লজিক লিখবে না, সাথে স্ট্রাকচারটা এমনভাবে সাজাবে:

text

src/

  features/

    auth/

      components/

        LoginForm.tsx

        SignupForm.tsx

      hooks/

        useAuth.ts

      services/

        authService.ts

      types/

        index.ts

      index.ts

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

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

বড় প্রজেক্টে আমরা প্রায়ই দেখি, এক ফাইল থেকে আরেক ফাইলে রিলেটিভ ইম্পোর্ট পাথ ভুল হয়ে যায় ফাইল সরানোর কারণে। Claude Code ফাইল রিনেম বা মুভ করলে অটোমেটিকভাবে সমস্ত রেফারেন্স আপডেট করে দেয়। মানে শুধু ফাইল সরানো নয়, পুরো প্রজেক্টের ইম্পোর্ট স্টেটমেন্টগুলাও সে ঠিক করে দেয় — এটা যেকোনো ম্যানুয়াল কাজের চেয়ে বহুগুণ ফাস্ট আর নির্ভুল।

আরেকটা ইন্টারেস্টিং ফিচার হচ্ছে Claude Code-এর “ফাইল ট্রি অ্যাওয়ারনেস”। আপনি চাইলে তাকে বলতে পারেন, “আমার প্রজেক্টের সবগুলো ফাইল একবার স্ক্যান করো আর ইউনিফাইড এক্সপোর্ট বারেল ফাইল বানাও।” সে সবগুলো মডিউল স্ক্যান করে একটি index.ts (বা barrel file) তৈরি করবে, যাতে করে আপনি চাইলে এক জায়গা থেকে সুন্দর করে সব ইম্পোর্ট করতে পারেন। এটা বড় প্রোজেক্টের জন্য অসাধারণ একটা অর্গানাইজেশন টুল।

Claude Code শুধু ফাইল-ফোল্ডার সাজায় না, পুরো প্রজেক্টের আর্কিটেকচার নিয়েও ভাবে। ধরুন আপনি একটা নেক্সট জেএস প্রজেক্ট শুরু করছেন। Claude Code-কে বললেন, “আমি এমন একটা প্রজেক্ট চাই যেখানে অ্যাপ রাউটার, টেইলউইন্ড সিএসএস, প্রিজমা অ্যান্ড পোস্টগ্রেস থাকবে।”

Claude Code প্রথমে প্রজেক্ট স্ক্যাফোল্ড করবে। এরপর ফোল্ডার স্ট্রাকচার দাঁড় করাবে:

text

my-app/

  app/

    (routes)

  components/

    ui/

    layout/

  lib/

    prisma.ts

    utils.ts

  hooks/

  types/

  prisma/

    schema.prisma

  public/

  styles/

  tailwind.config.ts

  tsconfig.json

তারপর প্রয়োজনীয় কনফিগারেশন ফাইল অ্যাড করবে, প্যাকেজ ইন্সটল করে দেবে, প্রিজমা স্কিমা সেটআপ করে ডেটাবেস কানেকশন রেডি করবে — আর পুরো সময় জুড়ে ফাইল-ফোল্ডার গোছানো থাকবে স্কেলেবল উপায়ে। এককথায় Claude Code শুধু “কোড লেখে” না — সে প্রজেক্ট “তৈরি করে”।

একটা জরুরি বিষয়: Claude Code কখনো আপনার তৈরি করা কাঠামো ভাঙে না। আপনি যদি বলেন, “আমি চাই পেজেস ফোল্ডার রেখে কাজ করতে”, তাহলে সে তার ভেতরেই ফিচার ফোল্ডার বানাবে, বাইরের কিছু না ভেঙে। এই রেসপেক্টফুল বিহেভিয়রটাই Claude Code-কে অন্যান্য টুল থেকে আলাদা করে।

প্রজেক্টের শুরুতেই Claude Code-কে জানিয়ে দিন আপনি কোন স্ট্রাকচার ফলো করবেন। CLAUDE.md ফাইলে কিছু গাইডলাইন লিখে রাখতে পারেন:

markdown

# Project Conventions

- Use feature-based folder structure inside `src/features/`

- Each feature has `components/`, `hooks/`, `services/`, `types/`

- Use barrel exports (index.ts) for clean imports

- Keep shared code in `src/shared/`

এতে Claude Code সেই অনুযায়ী প্রতিবার ফাইল বানাবে।

বলুন, “আমার অ্যাপে ইউজার ড্যাশবোর্ড ফিচার অ্যাড করো।” Claude Code নিজেই বুঝবে ড্যাশবোর্ড ফোল্ডার কোথায় হবে, কী কী ফাইল লাগবে। কীভাবে ফোল্ডার স্ট্রাকচার করবে তা তাকে বলে দিতে হবে না — এটাই Claude Code-এর এজেন্টিক ইন্টেলিজেন্স।

আগে থেকে গোলমেলে থাকা প্রোজেক্ট ক্লিন করতে চাইলে Claude Code-কে বলুন, “আমার components ফোল্ডারটা রিফ্যাক্টর করো। অ্যাটমিক ডিজাইন প্রিন্সিপালে সাজাও।” সে ফোল্ডার স্ক্যান করে একটা প্রস্তাবনা দেবে — atoms/, molecules/, organisms/, templates/ ইত্যাদি। আপনি অ্যাপ্রুভ করলেই পুরো ফাইল স্ট্রাকচার পাল্টে দেবে এবং ইম্পোর্ট আপডেট করবে। এটা ম্যাজিকের মত!

Claude Code তার ভেতরেই ফাইল ট্রি দেখায় না, তবে আপনি চাইলে তাকে বলতে পারেন, “আমার প্রোজেক্টের ফাইল ট্রি JSON আকারে দাও” বা “একটা ASCII tree বানাও”। সেটা দেখে আপনি অর্গানাইজেশন অডিট করতে পারবেন। পরে কোন ফোল্ডারে কী আছে সেটার উপর ভিত্তি করে Claude Code-কে রিফাইনমেন্টের নির্দেশ দিতে পারবেন।

বড় প্রজেক্টে একই কোড বারবার লেখার সমস্যা খুব কমন। Claude Code যখন দেখে একই ধরনের ফাংশন বা কম্পোনেন্ট একাধিক জায়গায় আছে, সে আপনাকে নোটিফাই করে এবং প্রস্তাব দেয়, “এই ইউটিলিটি ফাংশনটা আমি shared/utils/-এ সরিয়ে রিফ্যাক্টর করতে পারি। চাইলে করব?” আপনি হ্যাঁ বললেই Claude Code ফাংশনটা এক জায়গায় নিয়ে আসে, সব রেফারেন্স ঠিক করে, আর পুরনো ডুপ্লিকেট রিমুভ করে দেয়। এভাবে প্রজেক্ট ধীরে ধীরে DRY (Don't Repeat Yourself) প্রিন্সিপাল ফলো করতে শুরু করে, আর আপনার ফাইল স্ট্রাকচারও হালকা ও পরিষ্কার হয়।

অনেক ডেভেলপার ভাবেন, ফোল্ডার স্ট্রাকচার তো নিজেরাও করতে পারবেন। আসলেই পারেন। কিন্তু একটা বড় প্রজেক্টে টানা কয়েক মাস কাজ করার পর যখন দেখবেন কম্পোনেন্ট ফোল্ডারে আশিটা ফাইল, ইউটিলিটির ভেতর দশটা সাবফোল্ডার আর কোনটার কী নাম মনে করতে পারেন না — তখন বুঝবেন কনসিস্টেন্সি বজায় রাখা কঠিন। Claude Code-কে একবার কনভেনশন শিখিয়ে দিন, সে সারাজীবন সেটা মেনে চলবে। আর যখন নতুন কোনো ডেভেলপার টিমে যোগ দেবে, তখন Claude Code-ই তার হয়ে ফাইল বানিয়ে দেবে, ফলে কনভেনশন ভাঙার সম্ভাবনা শূন্য।

আরও বড় সুবিধা হচ্ছে, Claude Code বয়লারপ্লেট ফাইল ক্রিয়েশনের পুরো ঝামেলা সরিয়ে দেয়। একটা মডিউল বানাতে গেলে আপনাকে বারবার ফোল্ডার, index.ts, টাইপ ফাইল, টেস্ট ফাইল — এসব ক্রিয়েট করতে হয়। Claude Code এক কমান্ডে সবগুলো ফাইল তৈরি করবে সাথে প্রয়োজনীয় কনটেন্টসহ। এতে আপনার সময় বাঁচে আর ফোকাস থাকে বিজনেস লজিকে।

মনেকরি আপনার একটি এক্সপ্রেস জেএস অ্যাপ আছে যেটাতে কোনো রকম অর্গানাইজেশন নেই — সব রাউট এক ফাইলে, কন্ট্রোলার আর মডেল মিশে আছে। আপনি Claude Code-কে বললেন, “এই প্রজেক্টকে MVC প্যাটার্নে রিফ্যাক্টর করো।”

routes/ ফোল্ডার বানিয়ে প্রতিটা রিসোর্সের জন্য আলাদা রাউট ফাইল (যেমন userRoutes.ts, productRoutes.ts)

controllers/ ফোল্ডারে কন্ট্রোলার লজিক সরিয়ে নেওয়া

models/ ফোল্ডারে ডেটাবেস মডেল

middlewares/, utils/, config/ আলাদা

সমস্ত ফাইলে ইম্পোর্ট ঠিক করে দেওয়া

এরপর পুরনো গোলমেলে ফাইল সে আর্কাইভ করে বা ডিলিট করতে বলে। পুরো প্রক্রিয়ায় Claude Code আপনার কাছ থেকে অনুমতি নেয়, আপনি চাইলে প্রতিটি স্টেপ রিভিউ করতে পারবেন। এটা সত্যিই একজন সিনিয়র ডেভেলপারের মতো কাজ।

ফোল্ডার/ফাইল স্ট্রাকচার অপটিমাইজ করার কিছু Claude Code প্রম্পট

নতুন ইউজারদের জন্য কিছু তৈরি প্রম্পট:

আমার রিএক্ট প্রজেক্টে ফিচার-বেসড ফোল্ডার স্ট্রাকচার সেটআপ করো।

এই প্রজেক্টের সমস্ত ফাইল অ্যানালাইজ করে একটা ক্লিন আর্কিটেকচার প্রপোজ করো।

src/components-এর ভেতরে অ্যাটমিক ডিজাইন অনুযায়ী ফোল্ডার গুছিয়ে দাও।

ডুপ্লিকেট ইউটিলিটি ফাংশন খুঁজে বের করে shared/utils-এ রিফ্যাক্টর করো।

নতুন যে মডিউল যোগ করছি, সেটার জন্য ফোল্ডার, টাইপ, টেস্ট ফাইল একসাথে ক্রিয়েট করো।

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