doubt.nvim AGENTS.md

Project instructions for doubt.nvim, a Neovim plugin for recording code-review concerns, saving review sessions, and exporting them. Neovim is a text editor that can be extended with Lua plugins.

In plain words
What is it for?
Use it when changing, reviewing, testing, or handing off work on doubt.nvim.
Why use it?
It tells coding agents where the plugin's parts live and which build, lint, and test practices preserve its existing behavior.

Instructions file for CodexOpenCode

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/makefinks/doubt.nvim/agents-md
Clone the repo
git clone --depth 1 https://github.com/makefinks/doubt.nvim

Made for: Codex, OpenCode.

Per session 1,625 This file is loaded in full into every session.
When invoked 1,625 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.

ModelPer sessionOnce invoked
Fable 5 $0.01625 $0.01625
Opus 5 $0.00813 $0.00813
Sonnet 5 $0.00325 $0.00325
Haiku 4.5 $0.00162 $0.00162

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

Security

Grade A, and why

doubt.nvim 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.

AGENTS.md · 154 lines

How it starts

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

AGENTS.md

Operational guidance for coding agents working in doubt.nvim. This file is intentionally practical: run commands exactly as listed, follow module ownership, and preserve existing behavior unless explicitly changing it.

Project Snapshot

  • Project: doubt.nvim (Neovim plugin for skeptical code review and handoff export).
  • Language/runtime: Lua on Neovim APIs (vim.api, vim.fn, vim.ui, vim.json, vim.uv).
  • Required dependency: MunifTanjim/nui.nvim.
  • Entrypoints: plugin/doubt.lua bootstrap and require("doubt").setup(...).
  • Core workflow: create claims -> persist sessions -> refresh/reanchor freshness -> export XML/templates.

Repository Layout

  • plugin/doubt.lua: plugin bootstrap, command registration on load.
  • lua/doubt/init.lua: top-level orchestration and public API.
  • lua/doubt/config.lua: defaults, setup merge, highlights.
  • lua/doubt/claims.lua: claim normalization, sorting, anchor validation.
  • lua/doubt/state.lua: persistence and workspace-scoped session mutation.
  • lua/doubt/render.lua: extmarks/signs/inline note rendering.
  • lua/doubt/panel.lua: side panel UI and help modal.
  • lua/doubt/export.lua: XML and template rendering.
  • lua/doubt/input.lua: wrappers around nui.input and checklist input.
  • lua/doubt/commands.lua: :Doubt* command wiring.
  • lua/doubt/keymaps.lua: default keymaps and claim-kind mappings.
  • tests/*_spec.lua: Plenary/Busted-style headless Neovim specs.
  • tests/minimal_init.lua: minimal runtime setup for Plenary tests.
  • tests/helpers/bootstrap.lua: test bootstrap and minimal assertions.

Build, Lint, and Test Commands

There is no separate build step and no configured linter/formatter in-repo (stylua, luacheck, selene, make, and CI config are absent).

Use the Plenary headless runner for tests. scripts/run_tests.sh downloads plenary.nvim to .deps/plenary.nvim if PLENARY_DIR is not set.

# Run full test suite (all spec files)
./scripts/run_tests.sh

# Run one specific test file (single-test workflow)
./scripts/run_tests.sh tests/plugin_bootstrap_spec.lua

# Example: run another specific spec file
./scripts/run_tests.sh tests/claim_anchor_model_spec.lua

Read the full file on GitHub · 154 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. yesterday First seen · 154 lines · 1,625 tokens per session scan A 770212c8aead

Subscribe to this mod's changes

doubt.nvim AGENTS.md is an instructions file published in the GitHub repository makefinks/doubt.nvim (5 stars, last pushed 23d ago), licensed MIT. It adds 1,625 tokens to every session, about $0.0081 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.