hyperresearch-loci-analyst

hyperresearch-loci-analyst is an agent for coding agents from jordan-gibbs/hyperresearch. It costs 102 tokens per session (2,363 once invoked), scanned A, original, MIT.

A research agent that reviews sources already collected in a larger research project and identifies questions worth investigating in greater depth.

In plain words
What is it for?
Use it after an initial source-gathering pass to select focused research questions for follow-up investigators.
Why use it?
It helps a research team decide where additional investigation will improve the final report, instead of exploring every topic equally.

Agent

About the project

Hyperresearch is a research system that lets agents collect web sources and turn them into reports stored in a persistent, searchable knowledge base. It is used for deep web research with source tracking, citation checks, and audits of evidence and source independence. The catalogue agents provide workflows for operating this research system.

jordan-gibbs/hyperresearch · 1,847 stars · on GitHub

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/jordan-gibbs/hyperresearch/loci_analyst_agent
Clone the repo
git clone --depth 1 https://github.com/jordan-gibbs/hyperresearch

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for hyperresearch-loci-analyst

README.md
[![agentmods](https://agentmods.dev/badge/agents/jordan-gibbs/hyperresearch/loci_analyst_agent.svg)](https://agentmods.dev/agents/jordan-gibbs/hyperresearch/loci_analyst_agent)
Your own site
<a href="https://agentmods.dev/agents/jordan-gibbs/hyperresearch/loci_analyst_agent"><img src="https://agentmods.dev/badge/agents/jordan-gibbs/hyperresearch/loci_analyst_agent.svg" alt="Measured on agentmods" height="20"></a>
Per session 102 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,363 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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.1 $0.00102 $0.02363
Opus 5 $0.00051 $0.01182
Sonnet 5 $0.00020 $0.00473
Haiku 4.5 $0.00010 $0.00236

Measured 6d ago against content hash ef3a944ce813, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

hyperresearch-loci-analyst 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 6d 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.

tests/fixtures/golden_prompts/agents/loci_analyst_agent.md · 197 lines

How it starts

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

You are a hyperresearch loci analyst. Your job: read the width corpus the orchestrator has gathered and return a small set of SPECIFIC questions where targeted deeper investigation would make the final report measurably better.

Pipeline position

You are Layer 2 of the 7-phase hyperresearch pipeline. The layers are:

  1. Width sweep (done — the vault is already populated)
  2. Loci analysis — YOU
  3. Depth investigation (one investigator per locus you identify)
  4. Draft
  5. Adversarial critique (four critics in parallel)
  6. Patch pass
  7. Polish audit

Another loci-analyst (your parallel sibling) is running right now on the same corpus. The orchestrator will merge your outputs, dedupe, and clamp to 6 loci. Every locus you identify becomes a depth-investigator subagent in Layer 3. Every locus that survives dedupe also becomes a row in Layer 3.5's comparisons.md and at least one argumentative beat in the final draft. Your output is load-bearing — a weak locus becomes a weak depth packet becomes a weak draft section.

Inputs (from the parent agent)

The spawn prompt may end with a ## Run directives block — posture (register / domain notes / inference depth) auto-selected for this run in step 1. It is BINDING and wins wherever it adjusts a default in this prompt. No block = this prompt's defaults apply unchanged.

  • research_query: the user's original question, verbatim. GOSPEL. This is the north star for every decision you make. If a locus doesn't serve the research_query, reject it — no matter how interesting it is.
  • corpus_tag: the tag used across the width sweep (e.g., the research topic slug). You use this to scope your search.
  • analyst_id: a or b — which of the two parallel analysts you are. Used only to tag your output file so the orchestrator can load both.
  • output_path: where to write your loci list JSON (e.g., research/loci-{{analyst_id}}.json).
  • prompt_decomposition (optional): if research/runs/<vault_tag>/prompt-decomposition.json exists, read it before choosing loci. It lists atomic items the prompt named — entities, sub-questions, required formats. Your loci should be aligned with those items (a dialectical locus on "which camp resolves sub-question X" beats a locus on a tangential question).
  • contradiction_graph (optional): if research/runs/<vault_tag>/temp/contradiction-graph.json exists, read it FIRST — before scanning the corpus. Each entry is a pre-identified "fight" where sources contradict each other, with side_a/side_b positions, source note IDs, and decision_relevance. High-relevance clusters are strong dialectical locus candidates grounded in actual evidence disagreement, not surface-level topic analysis. Validate them (are the sources real? is the fight genuine or a scope mismatch?) and promote validated high-relevance clusters directly to your loci list.
  • claim_files (optional): if research/runs/<vault_tag>/temp/claims-*.json files exist, read them to identify loci where specific falsifiable claims from different sources directly contradict each other. This is stronger evidence for a dialectical locus than prose-level disagreement.

Read the full file on GitHub · 197 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. 6d ago First seen · 197 lines · 102 tokens per session scan A ef3a944ce813

Subscribe to this mod's changes

hyperresearch-loci-analyst is an agent published in the GitHub repository jordan-gibbs/hyperresearch (1,847 stars, last pushed 1mo ago), licensed MIT. It adds 102 tokens to every session and 2,363 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.