SPAWNING
SUBAGENTS
Inside One Session সাবএজেন্ট
স্পন করা
একটি সেশনের ভেতরে

The Story So Farএ পর্যন্ত গল্প

What Is a Subagent?সাবএজেন্ট কী?

Sessions vs Subagentsসেশন বনাম সাবএজেন্ট

The Fan-Out Patternফ্যান-আউট প্যাটার্ন

Worktree vs Shared DirectoryWorktree বনাম শেয়ার্ড ডিরেক্টরি

What an Agent Call Looks LikeAgent কল কেমন দেখায়

# Claude Code's Agent tool — the fields you control

Agent({
  description: "Security audit — src/auth/ module",

  prompt: """
    Read all files in src/auth/. Look for:
    - SQL/NoSQL injection vulnerabilities
    - Tokens or secrets stored in plain text
    - Session handling bugs (fixation, no expiry)
    - Overly permissive CORS or cookie settings

    Return a markdown list of findings. If none found, say so.
    Do NOT modify any files. Do NOT spawn subagents.
  """,

  # optional — picks a specialized agent type
  subagent_type: "security-reviewer"
})

The Subagent Fitness Checkসাবএজেন্ট উপযুক্ততা পরীক্ষা

• ✓ Batch analysis — same task across N targets (files, modules, PRs) ব্যাচ বিশ্লেষণ — N লক্ষ্যে একই কাজ (ফাইল, মডিউল, PR)
• ✓ Parallel read-only work — no shared writes between agents সমান্তরাল পড়ার কাজ — এজেন্টদের মধ্যে শেয়ার্ড রাইট নেই
• ✓ Well-defined deliverable — you know exactly what "done" looks like সুনির্দিষ্ট ফলাফল — "সম্পন্ন" কেমন দেখায় তা জানো
• ✓ Each subtask takes > 5 min — worth the overhead of spawning প্রতিটো উপকাজ > ৫ মিনিট — স্পন করার ওভারহেড সার্থক
• ✓ No mid-flight steering needed — you trust the prompt to guide it মাঝপথে স্টিয়ারিং দরকার নেই — প্রম্পটই পথ দেখাবে

Subagents Are the Wrong Tool When…সাবএজেন্ট ভুল টুল যখন…

• ✗ The task needs live steering — you'll want to course-correct mid-run কাজে লাইভ স্টিয়ারিং দরকার — মাঝপথে দিকনির্দেশনা বদলাতে হবে
• ✗ Scope is unknown / exploratory — you're not sure what "done" means yet স্কোপ অজানা / অন্বেষণমূলক — "সম্পন্ন" এখনো স্পষ্ট নয়
• ✗ Agents write to the same files — race conditions, corrupted output এজেন্টরা একই ফাইলে লেখে — রেস কন্ডিশন, দূষিত আউটপুট
• ✗ Very short tasks (< 2 min each) — overhead of spawning > benefit খুব ছোট কাজ (< ২ মিনিট) — স্পনের ওভারহেড > সুবিধা

Habib's Q3 Problemহাবিবের Q3 সমস্যা

Writing the Orchestrator Promptঅর্কেস্ট্রেটর প্রম্পট লেখা

The Subagent Prompt Patternসাবএজেন্ট প্রম্পট প্যাটার্ন

Habib's Orchestrator — The Codeহাবিবের অর্কেস্ট্রেটর — কোড

# Habib asks Claude to fan out 4 security agents in parallel

Spawn 4 subagents simultaneously for a security audit of our nop-station platform.

Each agent should:
- Read all files in its assigned directory
- Return findings in this format:
  ## [Module] Security Findings
  **[SEVERITY]** `file:line` — description of issue
- If no issues found, return "No findings in [module]."
- Do NOT modify files. Do NOT spawn subagents.

Assignments:
Agent(description="Auth security audit",    prompt="Audit src/auth/ ...")
Agent(description="Payments security audit", prompt="Audit src/payments/ ...")
Agent(description="API security audit",      prompt="Audit src/api/ ...")
Agent(description="Admin security audit",    prompt="Audit src/admin/ ...")

# After all 4 return: compile into a single security report
# Sort findings by severity. Count totals per module.

Total Time = Slowest Agentমোট সময় = সবচেয়ে ধীর এজেন্ট

One Message Per Agent. Then Synthesize.প্রতি এজেন্টে এক বার্তা। তারপর সংকলন।

Budget Before You Spawnস্পন করার আগে বাজেট করো

Runaway Cost Spiralsনিয়ন্ত্রণহীন খরচের স্পাইরাল

You Can't Steer Mid-Flightমাঝপথে স্টিয়ার করা যায় না

Habib's 4 Agents — The Full Runহাবিবের ৪ এজেন্ট — পূর্ণ রান

# Each subagent prompt follows the same pattern:

Agent(description="Auth security audit", prompt="""
  Read all files in src/auth/. Identify:
  - Injection vulnerabilities (SQL, NoSQL, command)
  - Plain-text secrets or tokens
  - Session handling bugs

  Return findings as:
  ## Auth Findings
  **[HIGH/MED/LOW]** `file:line` — description

  If no issues: return "No findings in src/auth/"
  Do NOT modify files. Do NOT spawn subagents.
""")

# Agents B, C, D: identical structure, different path + checks
Agent(description="Payments security audit", prompt="... src/payments/ ... PCI exposure ...")
Agent(description="API security audit",      prompt="... src/api/ ... auth guards, rate limits ...")
Agent(description="Admin security audit",    prompt="... src/admin/ ... privilege, creds ...")

28 Minutes. 4 Modules. 11 Findings.২৮ মিনিট। ৪ মডিউল। ১১ ফাইন্ডিং।

Which Tool Do You Reach For?কোন টুল নেবে?

Spawning Subagents — The Basicsসাবএজেন্ট স্পন করা — মূল বিষয়