osp-rules

osp-rules is a cursor rule for Cursor from amirkiarafiei/open-scholar-peer. It costs 868 tokens per session, scanned A, original, MIT.

A set of always-on rules for Open ScholarPeer, a workflow for reviewing research papers. It controls how review steps read files, track progress, and use different roles.

In plain words
What is it for?
It helps manage paper-review state, route commands to the correct step, and record completed phases in .brain/session.json.
Why use it?
It prevents review steps from losing their place, loading unrelated files, or mixing responsibilities. It also makes reruns and unfinished work visible.

Cursor rule for Cursor

Written for Cursor: installed under .cursor/. Also seen: mentions subagents; mentions Claude Code; mentions Codex.

Good fit It helps manage paper-review state, route commands to the correct step, and record completed phases in .brain/session.json.

Compare 6 cursor rules from other repositories ↓
Install with agentmods
npx agentmods add rules/amirkiarafiei/open-scholar-peer/osp-rules
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.

Clone the repo
git clone --depth 1 https://github.com/amirkiarafiei/open-scholar-peer

Made for: Cursor.

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 osp-rules

README.md
[![agentmods](https://agentmods.dev/badge/rules/amirkiarafiei/open-scholar-peer/osp-rules/github.svg)](https://agentmods.dev/rules/amirkiarafiei/open-scholar-peer/osp-rules)
Your own site
<a href="https://agentmods.dev/rules/amirkiarafiei/open-scholar-peer/osp-rules"><img src="https://agentmods.dev/badge/rules/amirkiarafiei/open-scholar-peer/osp-rules/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for osp-rules

Your own site · 80×15
<a href="https://agentmods.dev/rules/amirkiarafiei/open-scholar-peer/osp-rules"><img src="https://agentmods.dev/badge/rules/amirkiarafiei/open-scholar-peer/osp-rules.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 868 This file is loaded in full into every session.
When invoked 868 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.00868 $0.00868
Opus 5 $0.00434 $0.00434
Sonnet 5 $0.00174 $0.00174
Haiku 4.5 $0.00087 $0.00087

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

Security

Grade A, and why

osp-rules 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 9d 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.

extensions/.cursor/rules/osp-rules.mdc · 63 lines

How it starts

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

Open ScholarPeer — Always-On Rules

These rules apply automatically in any project where Open ScholarPeer is installed.

Brain protocol (apply on every invocation)

  1. Read .brain/session.json first to understand current state.
  2. Load only the artifacts in the active step's reads: contract (see docs/ARTIFACT_CONTRACTS.md). Do not load the full .brain/ directory.
  3. After completing a step, update session.json: set the matching phases.<name> block to completed, set completed_at, and update resume_from.
  4. Re-runs overwrite with a warning. If a step is already completed, print one warning, then proceed.

Persona discipline

  • Each numbered command (/N-osp-*) activates exactly one persona skill (osp-<name>-agent). Do not blend personas.
  • The Q&A engine (/5-osp-qa) uses two personas at once: Query Agent (main thread) and Answer Generator (subagent, or self-reflection on tools that lack subagents).
  • The orchestrator (osp-orchestrator) never performs review work — it only routes.

Subagent vs self-reflection

  • Prefer subagents for the Q&A engine on tools that support them (Claude Code, Cursor, Gemini CLI, Copilot CLI, Codex CLI, Qwen Code, OpenCode, Junie, Kiro, Kimi Code).
  • Fall back to self-reflection with strict turn markers (=== Query Agent === ... === END === === Answer Generator === ...) on tools without (or with only partial) subagent support: Antigravity, Mistral Vibe, OpenHands.
  • Self-reflection is a documented weaker substitute. See KNOWN_LIMITATIONS.md.

User orientation (required on every phase invocation)

Before doing any work in a phase, print a short orientation block so the user always knows where they are:

── <Phase name> ──────────────────────────────────────────
What this phase does: <one sentence — the agent's role and why this step exists>
Reads:  <list the key input files>
Writes: <list the key output files>
Effort: <rough estimate — "~2 min, ~N tool calls", etc.>
──────────────────────────────────────────────────────────

Read the full file on GitHub · 63 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. 9d ago First seen · 63 lines · 868 tokens per session scan A fd4c71f15535

Subscribe to this mod's changes

osp-rules is a cursor rule published in the GitHub repository amirkiarafiei/open-scholar-peer (27 stars, last pushed 1mo ago), licensed MIT. It adds 868 tokens to every session, about $0.0043 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.