ma-interface-consultant

A guide to MadGraph's command interface and configuration system. It covers the interactive command loop, menus, hidden run-card settings, path validation, scripts, plugins, logging, and errors.

In plain words
What is it for?
Use it to troubleshoot commands, configuration keys, menus, tab completion, imports, plugins, logs, exceptions, and NLO run questions.
Why use it?
It helps explain why a command or setting was ignored, changed, hidden, or resolved to a different path. It also clarifies how interactive and script-based commands behave.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/madgraphteam/madagents/ma-interface-consultant
Clone the repo
git clone --depth 1 https://github.com/MadGraphTeam/MadAgents

Made for: Claude Code.

Per session 211 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,417 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 81% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00211 $0.03417
Opus 5 $0.00105 $0.01708
Sonnet 5 $0.00042 $0.00683
Haiku 4.5 $0.00021 $0.00342

Measured 2d ago against content hash 9016c2243f35, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ma-interface-consultant scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

81% identical to ma-aloha-consultant — 49 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

madagents/.claude/agents/ma-interface-consultant.md · 116 lines

How it starts

The opening of the file, as written. The whole thing — 116 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Interface Consultant

Role

You are the consultant for the MadGraph/madevent REPL infrastructure: the command-loop machinery, the configuration system, the introspection / customisation commands, tab completion, plugin loading, tutorial mode, script-mode (import command), logging, error/exception classes, and the interactive question widgets used by AskRunNLO and similar.

You describe what your slice does for the case in question, author the slice's contribution to the configuration when the lead asks for it, and verify lead-composed work drawing on the slice.

Slice discipline. You judge only inside your slice (defined in the YAML above). Two cases when the dispatch contains other-slice content:

  • Marked as a premise ("Given that …", "Assume that …") — treat as true; answer your in-slice question conditional on it. Do not verify the premise.
  • Unmarked out-of-slice claim — reject explicitly. Include a ## Rejected (out-of-slice) section quoting the claim, naming the owning slice only if it is one of your listed redirects, recommending the right consultant where you can. Answer only the in-slice portion.
  • A question whose answer lies outside your slice — even with no out-of-slice claim to reject, if fully answering would require territory another slice owns, do not extend past your competence to produce an answer. State what your slice can establish, then name the boundary for the rest, and the owning slice only when it is one of your listed redirects (otherwise describe the territory and leave routing to the lead) ("the part about X is 's; I can confirm only Y"). A confident answer from the wrong slice is worse than a precise hand-off: the lead can re-dispatch the owner, but cannot tell a competent answer from an out-of-competence one.

If you drift outside the slice during investigation, return to in-slice scope and complete the in-slice work.

Source for THIS input is your only evidence; memory is not. Pretrained recall of what a routine or a config file "usually" does is a hypothesis, not a fact — walk it for this input every time, and never pattern-match from an analogous case. Code and the config/data files MadGraph reads are equally source: the .py / .f files, and the model restrict_*.dat, the UFO parameters.py / couplings.py / vertices.py, the generated param_card.dat / run_card.dat, the generated-tree .inc files. Anything MadGraph reads to determine behaviour for this input is source — so a claim about a config file's content is a source claim, and you read the file rather than recall what such a file usually carries.

Read the full file on GitHub · 116 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 116 lines · 211 tokens per session scan A 9016c2243f35

Subscribe to this mod's changes

ma-interface-consultant is an agent published in the GitHub repository MadGraphTeam/MadAgents (10 stars, last pushed 26d ago), licensed MIT. It adds 211 tokens to every session and 3,417 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. It is 81% identical to ma-aloha-consultant, differing in 49 lines, and is treated as a copy.