suasor AGENTS.md

suasor AGENTS.md is an instructions file for Codex, OpenCode from ozzy-labs/suasor. It costs 2,728 tokens per session, scanned A, original, MIT.

Project instructions for coding agents working on Suasor, a local-first AI assistant that gathers and searches information from work tools.

In plain words
What is it for?
Guiding changes to Suasor while preserving event sourcing, local data storage, human approval for writes, and its required development practices.
Why use it?
They give agents the project's language, architecture rules, privacy boundaries, and development process to follow.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions 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 instructions/ozzy-labs/suasor/agents-md
Clone the repo
git clone --depth 1 https://github.com/ozzy-labs/suasor

Made for: Codex, OpenCode.

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 suasor AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ozzy-labs/suasor/agents-md.svg)](https://agentmods.dev/instructions/ozzy-labs/suasor/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/ozzy-labs/suasor/agents-md"><img src="https://agentmods.dev/badge/instructions/ozzy-labs/suasor/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,728 This file is loaded in full into every session.
When invoked 2,728 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.1 $0.02728 $0.02728
Opus 5 $0.01364 $0.01364
Sonnet 5 $0.00546 $0.00546
Haiku 4.5 $0.00273 $0.00273

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

Security

Grade A, and why

suasor 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 5d 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.

AGENTS.md · 129 lines

How it starts

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

AGENTS.md

このファイルは AI エージェント向けの共通 instructions です(Codex CLI / Gemini CLI / GitHub Copilot CLI が読み込む。Claude Code は CLAUDE.md を併読)。

基本方針

  • 日本語で応答する
  • 推奨案とその理由を提示する
  • .env ファイルは読み取り・ステージングしない
  • 破壊的な Git 操作を避ける

プロジェクト概要

SuasorGathers, remembers, advises - you decide.

ローカルファーストの AI 秘書。チャット・メール・カレンダー・ドキュメント・コード・Web に散らばった業務情報をあなたの手元のプライベートメモリに集め、あなたと AI エージェントが MCP 経由で検索・要約できるようにする。そして助言し、返信・タスク・決定を提案する。送信も書き込みも、あなたの承認なく行わない(HITL)

アーキテクチャ不変条件(必読・docs/adr が正本)

実装・レビュー時は以下を絶対に崩さないこと。詳細は docs/adr/:

  1. event-sourced — 追記専用 event store が真実。projection(読みモデル)は replay で再構築可能(ADR-0002
  2. local-first / 外部送信最小化 — 取り込みは read 専用、本文は手元に保持、勝手に外へ出さない(ADR-0003
  3. MCP = エージェント境界 + HITL — 機能は MCP tool として公開。write 系は人の承認なしに適用しない(ADR-0004
  4. FTS-first retrieval — 検索の既定は SQLite FTS5。embedding は任意の Ollama サイドカー(無効時は FTS に graceful 劣化)(ADR-0005
  5. ML 委譲(最重要)重い ML をプロセス内で実行しない。LLM/embedding/OCR/STT は API・ローカルサイドカー(Ollama 等)・小さな言語中立 binding に委譲。src/ にモデル実体を置くディレクトリを作らない(ADR-0006
  6. connector 契約 — 取り込みは共通 contract 実装(ADR-0007)/ アシスタント skillADR-0008)/ マルチエージェント中立ADR-0009)/ 配布 npm + Bun 単一バイナリ + Docker(+Ollama)(ADR-0010

開発プロセス(spec-driven・必読)

  • ドキュメント先行: docs/requirements/docs/adr/docs/design/ → ユーザー doc を実装より先に確定する
  • 全変更を Issue + PR(GitHub Flow / squash merge のみ / main 直 push 禁止 = ruleset で強制)
  • ブランチ命名 <type>/<short-description>、Conventional Commits、PR タイトルもコミット規約に合わせる
  • squash commit の本文は空(repo 設定 squash_merge_commit_message=BLANK / title は PR タイトル)。PR 本文をそのまま commit 本文にすると、行またぎの括弧などで release-please の Conventional Commits パーサが commit ごと取りこぼし、changelog / version bump から脱落する。破壊的変更やリリースノートに残したい footer は、マージ時に明示的に渡す:

Read the full file on GitHub · 129 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. 5d ago First seen · 129 lines · 2,728 tokens per session scan A 553d0a206b7a

Subscribe to this mod's changes

suasor AGENTS.md is an instructions file published in the GitHub repository ozzy-labs/suasor (0 stars, last pushed 25d ago), licensed MIT. It adds 2,728 tokens to every session, about $0.0136 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.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens