goodboy AGENTS.md

goodboy AGENTS.md is an instructions file for Codex, OpenCode from akhayam99/goodboy. It costs 1,263 tokens per session, scanned A, original, MIT.

A project guide for the Goodboy codebase that explains where files belong, how code is named, and how components, exports, and state stores are organized. It is separate from the project's monorepo process rules.

In plain words
What is it for?
Adding features, naming components and utilities, organizing Zustand state, choosing export patterns, and locating the right project documentation before editing.
Why use it?
It helps agents place new code in the correct feature or application area and follow conventions that keep the codebase understandable. It also points to the documents that define testing and architecture details.

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

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/akhayam99/goodboy/agents-md.svg)](https://agentmods.dev/instructions/akhayam99/goodboy/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/akhayam99/goodboy/agents-md"><img src="https://agentmods.dev/badge/instructions/akhayam99/goodboy/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,263 This file is loaded in full into every session.
When invoked 1,263 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.01263 $0.01263
Opus 5 $0.00632 $0.00632
Sonnet 5 $0.00253 $0.00253
Haiku 4.5 $0.00126 $0.00126

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

Security

Grade A, and why

goodboy 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 4d 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 · 115 lines

How it starts

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

AGENTS.md

Read this when you're an agent about to write code here and need the working-memory floor and forbidden-patterns checklist. Not for monorepo process rules, which live in CONVENTIONS.md.

Agent-agnostic code conventions. Process and monorepo rules live in CONVENTIONS.md. Full layout and test placement live in docs/file-system.md.

Where new code goes

  • One feature only: features/<domain>/.
  • App routing, layout, or boot: app/components/<Name>/.
  • Reusable and cross-feature placement follows the boundary in docs/file-system.md.
  • Zustand state: store/slices/<domain>/.
  • Database migrations follow docs/architecture.md.

Naming

  • Components and their folders use PascalCase.
  • Utilities, helpers, and hooks use camelCase; hooks prefix use.
  • A file matches its primary export. Constants use SCREAMING_SNAKE_CASE.
  • Booleans prefix is, has, can, or should.
  • Components use a local type Props. Function, hook, and utility parameter types follow the complete Params rule in docs/typescript/components.md.
  • Domain and data types keep descriptive names.

Components and exports

Sub-components do not live inline in a parent component file. Extract them to a sibling file in the same folder. A reusable utility goes to shared/utils/; a domain-owned utility stays beside its owner.

Keep one main export per file. Keep public barrels minimal, and import internal cross-file dependencies from their source. Full component and export rules live in docs/typescript/components.md.

Store selectors and memoization

  • A useAppStore selector returns a primitive or a reference the store owns. A fresh collection needs useShallow or the required proof directive.
  • Select the keys a consumer needs, never a whole write-heavy slice. useShallow does not make a broad subscription acceptable.
  • Memoize a list row only when its props are primitives or stable references, and memoize the work behind it.

Read the full file on GitHub · 115 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. 4d ago First seen · 115 lines · 1,263 tokens per session scan A 651db325b3db

Subscribe to this mod's changes

goodboy AGENTS.md is an instructions file published in the GitHub repository akhayam99/goodboy (89 stars, last pushed today), licensed MIT. It adds 1,263 tokens to every session, about $0.0063 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.