ronykit AGENTS.md

Repository instructions for ronykit, a Go workspace for building and running the Ronykit framework and its command-line tools.

In plain words
What is it for?
Use them when developing or testing the Go modules, working with Ronykit areas, configuring optional environment variables, or using its MCP knowledge and scaffolding tools.
Why use it?
They explain the project structure, required setup, available agent integrations, and local editing rules, reducing guesswork during changes.

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

Made for: Codex, OpenCode.

Per session 2,107 This file is loaded in full into every session.
When invoked 2,107 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.02107 $0.02107
Opus 5 $0.01053 $0.01053
Sonnet 5 $0.00421 $0.00421
Haiku 4.5 $0.00211 $0.00211

Measured 3d ago against content hash 699e6603462e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ronykit 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 3d 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 · 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

Practical instructions for coding agents and contributors working in this repository.

Last verified: 2026-08-12 — every make target, path, and link in this file was checked against the tree at that commit.

  • Stack: Go 1.25+ multi-module workspace (go.work). No other language runtime is needed to build or test.
  • Scope: entire repository rooted at this directory.
  • Default approach: prefer minimal, targeted changes over broad refactors.
  • Local env: copy .env.example to .env (gitignored) for the optional OLLAMA_* / OPENAI_* / integration-test variables.

AI assistants

  • MCP: ronyup mcp (see .cursor/mcp.json) — knowledge resources and scaffold tools.
  • Skill: .agents/skills/ronykit-framework/ (Agent Skills layout; Cursor discovers it automatically) — invoke /ronykit-framework for orchestration; conventions live in MCP, not in the skill body. MCP index: references/mcp-map.md under that directory.
  • Path rules: .cursor/rules/*.mdc carry globs: frontmatter and load automatically when you edit kit/, rony/, intent/, std/, x/, ronyup/, or .agents/skills/. They hold the per-area detail that used to sit in this file — put new area-specific guidance there, not here.
  • Exclusions: .cursorignore keeps secrets and vendored bulk out of reach. Add new secret paths there, not only to .gitignore.

For scaffolded application workspaces (outside this monorepo), MCP knowledge and tools are the source of truth for service layout and handler conventions.

Context map

Context is layered: this file, plus whichever path rule matches your edit, is all that loads automatically. Everything else is opened deliberately — do not read it all up front.

When you are… Open
editing kit/, rony/, intent/, std/, x/, ronyup/, .agents/skills/ nothing — the matching path rule loads itself
scaffolding a workspace, service, or feature the ronykit-framework skill, then ronyup mcp resources
needing the request flow, key abstractions, or deeper architecture docs/architecture.md, docs/knowledge-architecture.md, docs/advanced-kit.md
changing agent behavior intent/README.md, intent/DESIGN.md
looking for the API contract or schema Contracts & schemas below
asked about dependency licenses docs/compliance.mdnever open COMPLIANCE.md, a 529 KB generated FOSSA export
working near the embedded API-doc UI never open x/apidoc/internal/swagger-ui/ or x/apidoc/internal/redoc-ui/ (vendored minified bundles)

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. 3d ago First seen · 154 lines · 2,107 tokens per session scan A 699e6603462e

Subscribe to this mod's changes

ronykit AGENTS.md is an instructions file published in the GitHub repository clubpay/ronykit (38 stars, last pushed 5d ago), licensed BSD-3-Clause. It adds 2,107 tokens to every session, about $0.0105 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.