S1 · BONUS EPISODE

Agent Swarms. এজেন্ট ঝাঁক।

One task. Hundreds of agents. All at once. একটা কাজ। শত শত এজেন্ট। একসাথে।

Shazzad
"Rifat, I just spun up 47 agents in parallel. On one task. In under a minute. I don't think we're in Kansas anymore." "রিফাত, আমি মাত্র ৪৭টা এজেন্ট একসাথে চালু করলাম। একটা কাজের জন্য। এক মিনিটেরও কম সময়ে। মনে হচ্ছে এটা আর আগের মতো না।"
RECAP · SEASON 1

The arc so far. এতক্ষণ পর্যন্ত যা শিখলাম।

Today: a new primitive. Not just parallel sessions — agents that coordinate with each other. আজ: নতুন একটা ধারণা। শুধু সমান্তরাল সেশন না — এজেন্ট যারা একে অপরের সাথে সমন্বয় করে।

THE SHIFT

From assistant to team. সহকারী থেকে দলে।

Beforeআগে

One Claude. One context. One stream of work. Hit a huge task → run out of context → restart.একটা Claude। একটা context। একটা কাজের ধারা।

Swarmsঝাঁক

Lead agent decomposes the task → spawns specialist agents → they run in parallel, message each other → converge on one result.লিড এজেন্ট কাজ ভাগ করে → বিশেষজ্ঞ এজেন্ট স্পন করে → সমান্তরালে চলে → একটা ফলাফলে মেলে।

The key insight: LLMs reason worse as context grows. Keep each agent small, focused, and fast. মূল উপলব্ধি: context বাড়লে LLM দুর্বল হয়। প্রতিটা এজেন্টকে ছোট, কেন্দ্রীভূত রাখো।

TWO FLAVORS

Swarms come in two forms. ঝাঁক দুই ধরনের।

Agent Teamsএজেন্ট টিম
👥Lead + teammates. Each is a full Claude instance.লিড + টিমমেট। প্রতিটাই পূর্ণ Claude ইন্সট্যান্স।
📬Teammates message each other directly — not just reporting to lead.টিমমেটরা সরাসরি মেসেজ করে।
📋Shared task board with dependencies & file locking.শেয়ার্ড টাস্ক বোর্ড ও ফাইল লকিং।
🧪Best for: cross-layer features, parallel code review.ভালো: ক্রস-লেয়ার ফিচার, সমান্তরাল রিভিউ।
Dynamic Workflowsডায়নামিক ওয়ার্কফ্লো
🎯Orchestrator spawns 10s–100s of subagents via the Task tool.অর্কেস্ট্রেটর ১০–১০০+ সাবএজেন্ট spawn করে।
🔇Subagents are isolated — no shared memory, no direct messaging.সাবএজেন্ট বিচ্ছিন্ন — শেয়ার্ড মেমরি নেই।
⚙️Orchestrator writes its own scripts dynamically.অর্কেস্ট্রেটর নিজেই স্ক্রিপ্ট লেখে।
🔄Best for: large-scale migrations, audits, batch codegen.ভালো: বড় মাইগ্রেশন, অডিট, ব্যাচ কোডজেন।
AGENT TEAMS · ANATOMY

Lead, teammates, mailbox. লিড, টিমমেট, মেইলবক্স।

Lead Agent — orchestrates, delegates, tracks লিড এজেন্ট — সমন্বয়, বিতরণ, ট্র্যাকিং
Frontend Agentফ্রন্টএন্ড
Backend Agentব্যাকএন্ড
Tests Agentটেস্ট
Review Agentরিভিউ
📬 Mailbox — direct agent-to-agent messaging 📬 মেইলবক্স — সরাসরি এজেন্ট থেকে এজেন্ট মেসেজ

Teammates don't just report to lead — they message each other. Backend tells frontend: "the endpoint is /api/v2/auth." টিমমেটরা শুধু লিডকে রিপোর্ট করে না — নিজেরা কথা বলে। ব্যাকএন্ড ফ্রন্টএন্ডকে বলে: endpoint কোনটা।

AGENT TEAMS · SETUP

One env flag. That's it. একটা env ফ্ল্যাগ। এটুকুই।

// .claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Then just ask naturally: তারপর স্বাভাবিকভাবে বলো:

Shazzad → Claude
"Create a team with 3 teammates to refactor the payment module in parallel — one for the service layer, one for tests, one for the API contract." "৩ জন টিমমেট দিয়ে পেমেন্ট মডিউল রিফ্যাক্টর করো — একজন সার্ভিস লেয়ারে, একজন টেস্টে, একজন API কন্ট্র্যাক্টে।"
AGENT TEAMS · TASK BOARD

Shared task board — no collisions. শেয়ার্ড টাস্ক বোর্ড — সংঘর্ষ নেই।

  • 🔒 File locking — two agents can't edit the same file simultaneously. ফাইল লকিং — দুই এজেন্ট একই ফাইলে একসাথে কাজ করতে পারে না।
  • 🔗 Dependencies — task B auto-unblocks when task A completes. ডিপেন্ডেন্সি — টাস্ক A শেষ হলে টাস্ক B স্বয়ংক্রিয়ভাবে শুরু হয়।
  • 📊 Plan approval gates — lead presents plan before risky work begins. প্ল্যান অ্যাপ্রোভাল — ঝুঁকিপূর্ণ কাজের আগে অনুমোদন নেওয়া হয়।
  • 🎯 Delegate mode — restrict lead to coordination only. Teammates do all writing. ডেলিগেট মোড — লিড শুধু সমন্বয় করে। টিমমেটরা সব লেখে।

Result: no race conditions, no overwritten work, clear dependency chains. ফলাফল: race condition নেই, ওভাররাইট নেই, পরিষ্কার dependency চেইন।

COMPARISON

Teammates vs subagents. টিমমেট বনাম সাবএজেন্ট।

Agent Teams
Subagents (Ep 3)
Communicationযোগাযোগ
Agent-to-agent + to leadপারস্পরিক + লিডে
Report to parent onlyশুধু parent-এ
Contextকনটেক্সট
Independent windowsস্বাধীন উইন্ডো
Inherit parent sliceparent-এর অংশ
Shared stateশেয়ার্ড স্টেট
Mailbox + task boardমেইলবক্স + বোর্ড
None (parent mediates)নেই (parent মধ্যস্থ)
Costখরচ
Higher (full instances)বেশি
Lower (scoped)কম
Best forউপযুক্ত
Cross-layer featuresক্রস-লেয়ার ফিচার
Parallel read/analysisসমান্তরাল বিশ্লেষণ
DYNAMIC WORKFLOWS

The orchestrator pattern. অর্কেস্ট্রেটর প্যাটার্ন।

Orchestrator receives high-level task অর্কেস্ট্রেটর উচ্চ-স্তরের কাজ পায়
↓
Decomposes + scopes + writes its own orchestration script কাজ ভাগ করে এবং নিজেই orchestration স্ক্রিপ্ট লেখে
↓
Agent 1
Agent 2
Agent 3
…
Agent N
↓
Collect results → validate → synthesize ফলাফল সংগ্রহ → যাচাই → সংশ্লেষণ
↓
One clean result handed back একটাই পরিষ্কার ফলাফল ফেরত

Orchestrator dynamically writes its own plan — you don't script the decomposition yourself. অর্কেস্ট্রেটর নিজেই পরিকল্পনা লেখে — তুমি decomposition নিজে করো না।

DYNAMIC WORKFLOWS · SETUP

Headless mode — the engine. হেডলেস মোড — ইঞ্জিন।

# Run Claude non-interactively — orchestrator or single agent
claude -p "Migrate all fetch() calls in src/ from v1 to v2 API"

# Cap turns to prevent runaway cost
claude -p "Refactor auth logic in auth/service.ts" --max-turns 20

# Shell-level parallelism — spawn 10 at once, rate-limited
ls src/services/*.ts \
  | xargs -P 10 -I {} \
    claude -p "Migrate fetch() calls in {}"

-p = non-interactive (print mode). -P 10 = 10 concurrent shells. --max-turns 20 = hard stop. -p = নন-ইন্টারেক্টিভ। -P 10 = ১০টা একসাথে। --max-turns 20 = কঠোর সীমা।

DYNAMIC WORKFLOWS · PROMPTS

Scoped prompts. No shared memory. সীমাবদ্ধ প্রম্পট। শেয়ার্ড মেমরি নেই।

Vague — burns tokensঅস্পষ্ট — টোকেন নষ্ট

"Migrate all API calls."

Agent doesn't know which file, which version, which output format. Wasted run.এজেন্ট জানে না কোন ফাইল, কোন ভার্সন। ব্যর্থ চেষ্টা।

Scoped — worksসীমাবদ্ধ — কাজ করে

"Migrate all fetch() calls in /src/services/userService.ts from APIv1 to APIv2. Replace api.get() with apiClient.get(). Preserve error handling. Return only changed lines."

Each agent needs ALL context in its prompt — agents don't share memory. If agent A discovers something, agent B won't know. প্রতিটা এজেন্টের prompt-এ সব context দাও — এজেন্টরা মেমরি শেয়ার করে না।

ADVANCED PATTERN

Generator + Validator. A GAN for code. জেনারেটর + ভ্যালিডেটর। কোডের জন্য GAN।

Generator Agentsজেনারেটর এজেন্ট
✍️Write code, make changes, implement featuresকোড লেখে, পরিবর্তন করে
📁Each agent owns a distinct file scope — no overlapপ্রতিটা এজেন্টের আলাদা ফাইল স্কোপ
⚡Run in parallel — no waiting on each otherসমান্তরালে চলে
Validator Agentsভ্যালিডেটর এজেন্ট
🔍Review diffs, hunt edge cases, try to break outputdiff রিভিউ করে, edge case খোঁজে
🔁Feed failures back to generators — iterateব্যর্থতা ফেরত পাঠায় — পুনরাবৃত্তি
✅Two reviewers per file before mergemerge-এর আগে প্রতিটা ফাইলে দুই রিভিউয়ার

This is the closest thing to a GAN for software engineering — adversarial agents converging on correct output. সফটওয়্যার ইঞ্জিনিয়ারিংয়ের জন্য GAN-এর সবচেয়ে কাছের জিনিস।

REAL WORLD

Bun: Zig → Rust. In eleven days. Bun: Zig থেকে Rust। এগারো দিনে।

Proof of concept: porting Bun's runtime প্রমাণ: Bun-এর runtime পোর্ট করা
750k lines of Rust generatedলাইন Rust কোড তৈরি
99.8% of test suite passingটেস্ট স্যুট পাস
11 days — with hundreds of parallel agents, 2 reviewers per fileদিন — শত শত সমান্তরাল এজেন্ট, প্রতিটা ফাইলে ২ রিভিউয়ার

A task that would have taken a team of engineers months — completed by agent swarms in under two weeks. একটা কাজ যা ইঞ্জিনিয়ারদের মাস লাগত — এজেন্ট ঝাঁক দুই সপ্তাহেরও কমে শেষ করল।

COST MODEL

Tokens scale linearly. Plan accordingly. টোকেন সরলরৈখিকভাবে বাড়ে।

1 agent১ এজেন্ট
~10k tok
10 agents১০ এজেন্ট
~100k tok
100 agents১০০ এজেন্ট
~1M tok
Haiku swapHaiku-তে
~250k tok
WATCH OUT

Subagents have no shared memory. সাবএজেন্টের শেয়ার্ড মেমরি নেই।

Agent 47 discovers
"The legacy auth module uses SHA-1 hashing — everything that touches it needs to handle this." "লেগ্যাসি auth মডিউল SHA-1 হ্যাশিং ব্যবহার করে।"

Agent 23 does not know this. It assumes SHA-256. It ships broken code. Agent 23 এটা জানে না। সে SHA-256 ধরে নেয়। ভাঙা কোড ship করে।

Fix: pass critical discoveries explicitly in every subagent's prompt. Or use Agent Teams where agents can message each other. সমাধান: গুরুত্বপূর্ণ তথ্য প্রতিটা subagent-এর prompt-এ দাও। বা Agent Teams ব্যবহার করো।

WATCH OUT

Rate limits are real. Control concurrency. Rate limit বাস্তব। concurrency নিয়ন্ত্রণ করো।

# BAD — spawning 200 agents instantly → API throttling
ls src/**/*.ts | xargs -P 200 -I {} claude -p "Migrate {}"

# GOOD — 10 concurrent max, plus max-turns guard
ls src/**/*.ts | xargs -P 10 -I {} \
  claude -p "Migrate {}" --max-turns 15

# GOOD — orchestrator uses Task tool internally (managed concurrency)
claude -p "Migrate all fetch() calls across src/ — spawn agents as needed"
DECISION GUIDE

Which tool for which job? কোন কাজে কোনটা?

Scenarioপরিস্থিতি
Useব্যবহার করো
Whyকেন
Cross-layer feature (FE + BE + tests)ক্রস-লেয়ার ফিচার
Agent Teamsএজেন্ট টিম
Agents need to talk to each otherপরস্পর কথা বলা দরকার
Migrate 200 files to new API২০০ ফাইল মাইগ্রেশন
Dynamic Workflowsডায়নামিক ওয়ার্কফ্লো
Files are independent — batch fan-outফাইলগুলো স্বাধীন
Audit codebase for security issuesনিরাপত্তা অডিট
Dynamic Workflows (Haiku)ডায়নামিক (Haiku)
Read-only, scoped, cheapরিড-অনলি, সস্তা
Add a new endpoint end-to-endনতুন endpoint end-to-end
Single session or Ep 3 subagentsসিঙ্গেল সেশন বা Ep ৩
Sequential steps, swarm overkillsequential — swarm দরকার নেই

Let the problem shape the tool. Activity isn't value. সমস্যা দিয়ে tool বেছে নাও। activity মানে value না।

WRAP UP

One engineer. A hundred agents. একজন ইঞ্জিনিয়ার। একশো এজেন্ট।

Agent Teamsএজেন্ট টিম

Lead + teammates + mailbox + task board. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1লিড + টিমমেট + মেইলবক্স + টাস্ক বোর্ড।

Dynamic Workflowsডায়নামিক ওয়ার্কফ্লো

Orchestrator + Task tool + claude -p + --max-turns. Hundreds of parallel agents — scoped, stateless, fast.অর্কেস্ট্রেটর + Task tool। শত শত সমান্তরাল — সীমাবদ্ধ, দ্রুত।

Key ruleমূলনীতি

Each agent should be focused, scoped, and replaceable. The swarm's power comes from simplicity at the leaf level.প্রতিটা এজেন্ট কেন্দ্রীভূত, সীমাবদ্ধ, এবং প্রতিস্থাপনযোগ্য হওয়া উচিত।

AGENT TEAMS DYNAMIC WORKFLOWS GAN PATTERN PARALLEL AT SCALE

Season 1 complete. You've gone from one agent to a swarm. What you build next is up to you. সিজন ১ সম্পন্ন। একটা এজেন্ট থেকে ঝাঁকে এলে। এখন তুমি কী বানাবে সেটা তোমার।