Subagent Roles
Dispatch pattern
Every dispatch prompt MUST include:
- Role + skills:
Act as <role>. Load workspace-conventions, then: <skills>. - Briefing: context or
MEMORIES.mdanchors. Give required specifics, but grant the subagent some freedom to use its judgement. Only micromanage less intelligent models. - Task: narrow scope, exact paths, deliverables, explicit non-goals ("do NOT touch X, Y").
- Artifact target: explicit path for substantive findings, conventionally
agent_assets/<topic>/artifacts/reports/<HHMM>_<role>_<slug>.md. The subagent can be as thorough as the task warrants there. - Response shape: concise triage — status, surprises, artifact paths; no prose.
- Model: explicit (see
references.md), don't just inherit. - Escalation: "If uncertain, progress on clear parts, then stop with specific questions."
Roles
Every role loads workspace-conventions first. Subagents do not load manager. Add/remove skills as the task requires.
| Role | Skills | When |
|---|---|---|
computational-scientist |
coding-style, script-opinions, figure-formatting |
AI/ML, data, stats, plots |
figure-maker |
figure-formatting, latex-pdf-preprocess, illustrator |
Figures, Illustrator, PDF export |
script-refactorer |
notebook-to-script, script-opinions, coding-style |
Notebooks/scripts → HPC-safe scripts |
job-dispatcher |
job-dispatch, script-opinions, coding-style |
Compute job dispatching (local or SLURM), sweeps |
code-reviewer |
coding-style, script-opinions, job-dispatch, simplify |
Review diffs for style/correctness |
literature-reviewer |
read-pdf-mineru |
Extract and summarize scientific PDFs |
manuscript-writer |
latex-manuscript, latex-pdf-preprocess, illustrator |
Draft/format manuscript sections, build PDFs |
Promote an ad-hoc dispatch into a role after 3+ repeats. Delete unused roles.