What is lite-research-agents AGENTS.md?

Repository instructions for a coding agent that performs research inside a project folder. They define startup reading, file boundaries, available skills, and how to work without spawning other agents.

Starting research tasks, selecting and invoking skills, following project instructions, and handling skill tasks that would normally use subagents.

They give the agent a fixed operating procedure and prevent it from reading or changing files outside the active project.

lite-research-agents AGENTS.md — Instructions file by frankaging

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 instructions/frankaging/lite-research-agents/agents-md

Clone the repo

git clone --depth 1 https://github.com/frankaging/lite-research-agents

Made for: Codex, OpenCode.

Per session 346 This file is loaded in full into every session.

When invoked 346 The same file — it is already loaded in full.

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.

Model	Per session	Once invoked
Fable 5	$0.00346	$0.00346
Opus 5	$0.00173	$0.00173
Sonnet 5	$0.00069	$0.00069
Haiku 4.5	$0.00035	$0.00035

Measured yesterday against content hash 38ddc031418e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

lite-research-agents AGENTS.md 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 yesterday.

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

Copies of this mod

1 near-identical copy found in the catalogue:

lite-research-agents AGENTS.md — 100% identical, 0 lines differ

AGENTS.md · 30 lines

What it actually says

Codex CLI — Research Agent Boot Contract

You are a research agent operating inside this repository. This file is your entry point.

On Startup

Read AGENT.md — your full operating instructions. Follow them without exception.
Read skills/SKILLS.md — the registry of all available skills. These are your tools.
Determine the active project:
- If the user specifies a project folder (e.g. projects/my-idea/), read <project>/PROJECT.md.
- If a project folder is already open in the IDE, read its PROJECT.md.
Follow the Bootstrap Sequence in AGENT.md (fresh vs. resume).

Sandbox Rule

You may only read from or write to files within the active project's sandbox_root. Default is the project folder itself. This rule cannot be overridden.

Invoking Skills

Skills are not pre-loaded. Read skills/SKILLS.md to see what is available. Invoke a skill by reading its SKILL.md file — the content enters your context and you follow the instructions inside.

For type: tool skills, run the entry_point script via shell. For type: agentic skills, you do not have a subagent spawning tool — follow the Single-Agent Fallback section in the skill's SKILL.md instead.

No Subagent Spawning

Codex runs as a single agent. When a skill playbook calls for spawning persona subagents, simulate each persona inline: prefix your response with the persona name and follow the persona definition strictly. Persona context isolation is reduced but the structured debate loop still applies.

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.

yesterday First seen · 30 lines · 346 tokens per session scan A 38ddc031418e

Subscribe to this mod's changes

lite-research-agents AGENTS.md is an instructions file published in the GitHub repository frankaging/lite-research-agents (3 stars, last pushed 5mo ago), licensed MIT. It adds 346 tokens to every session, about $0.0017 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-31.

Building agents Productivity Research agentic-workflow agents auto-research autoresearch claude-code claude-skills