by-campaign-manager

BY Campaign Manager

Plan, execute, monitor, and assess protein/antibody design campaigns. This skill governs how to size a campaign, track run state, coordinate multi-run efforts, estimate cost and time on each compute target (local GPU, HPC, Tamarind), monitor progress, and evaluate campaign health.

When to Use This Skill

Use this skill when you need to:

• ✅ Start a new design campaign — size designs/scaffolds, pick modality, choose compute tier
• ✅ Track run state through the campaign state machine (draft → configured → designing → screening → ranked → submitted)
• ✅ Estimate cost and time before launching (local GPU hours, HPC $/hr, Tamarind credits)
• ✅ Resume an interrupted campaign from the last checkpoint without re-doing work
• ✅ Assess mid-run health — pass rate trajectory, score distributions, abort/continue decisions
• ✅ Coordinate multi-run efforts — vary one parameter axis at a time, aggregate cross-run results
• ✅ Decide when to iterate — low pass rate, poor scores, insufficient diversity

Don't use this skill for:

• ❌ Target research and epitope mapping → use by-research
• ❌ Submitting individual jobs or scoring single designs → use by-design / by-screening
• ❌ Lab submission gating → use by-lab (triple-gated)
• ❌ HPC infrastructure setup → use by-deploy-compute
• ❌ Sequence/structure clustering for diverse panels → use by-diversity

Quick Start

A typical campaign launch from the planner sub-agent:

# 1. Capture user preferences (modality, tier, scaffolds)
/by:plan-campaign

# 2. Estimate cost on each compute target before approval
python scripts/estimate_campaign.py \
  --target PD-L1 \
  --modality vhh \
  --tier standard \
  --scaffolds 2

# 3. Initialize campaign state and launch design phase
#    (delegate via Task(by-design, ...))

# 4. Monitor mid-run
python scripts/track_progress.py \
  --campaign-dir campaigns/pdl1/campaign_20260520_001

Expected estimate_campaign.py output: cost table for local / HPC RunPod / Tamarind, with wall-clock hours and confidence intervals.