AGENTS.md_generator AGENTS.md

A project guide for coding assistants working on AGENTS.md Generator, a plain Python project. It explains the repository layout, coding rules, workflow, and commands for checking changes.

In plain words
What is it for?
Use it when changing or reviewing the AGENTS.md Generator codebase. It directs assistants to the right files and explains how to verify their work.
Why use it?
It gives assistants the project context and guardrails needed to make small, predictable changes without damaging the generator. It also records the commands used for formatting, linting, and tests.

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

Made for: Codex, OpenCode.

Per session 1,813 This file is loaded in full into every session.
When invoked 1,813 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.01813 $0.01813
Opus 5 $0.00907 $0.00907
Sonnet 5 $0.00363 $0.00363
Haiku 4.5 $0.00181 $0.00181

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

Security

Grade A, and why

AGENTS.md_generator 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 2d 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 259 lines

How it starts

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

AGENTS.md

This file is for coding agents (Codex/Claude/Cursor/etc.). Keep it strict and actionable.

Overview

  • Project: AGENTS.md Generator
  • Stack: python (vanilla)
  • Keep changes small and verifiable.

Repo context (read this first)

Project: AGENTS.md Generator Stack: python Repo root: .

Quick orientation
  • Start here:

    • README.md
  • CI workflows live in: .github/workflows/

  • Planning/spec drafts (if used):

    • Plans: plans/
    • Drafts/specs: drafts/
  • Useful scripts (if any): scripts/

Commands (copy/paste)

Lint

make lint

Format

make format

Tests

make test
Local environment notes
  • Prefer the repo's existing toolchain (don't upgrade it).
  • If you need new env vars: document names, don't invent secrets.
  • If a command fails due to missing deps, explain the minimal install step.
Where to put new things
  • Small scripts/utilities — scripts/
  • Specs/exec notes — drafts/
  • Plans (if requested) — plans/

Guardrails (how to not break AGENTS.md Generator)

Your job: be useful, be safe, be boring. Small diffs. Deterministic output. No surprises.

0) Scope & intent
  • Implement exactly what's requested. If requirements are ambiguous: ask one precise question (or make the smallest reasonable assumption and state it).
  • Prefer changing existing code over adding new systems.
  • Avoid framework upgrades unless explicitly asked.
1) Safe edits only
  • Keep diffs small (target: <300 lines unless unavoidable).
  • Never rewrite whole files when a patch will do.
  • Preserve formatting, naming patterns, and local conventions.
  • Follow the optional review guideline here: docs/agent-guidelines.md.
2) No destructive operations
  • Do not delete data, migrations, buckets, or user files.
  • Avoid broad refactors touching many modules at once.
  • Never remove features because unused without explicit instruction.

Read the full file on GitHub · 259 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. 2d ago First seen · 259 lines · 1,813 tokens per session scan A 5ebdc6bb916f

Subscribe to this mod's changes

AGENTS.md_generator AGENTS.md is an instructions file published in the GitHub repository markoblogo/AGENTS.md_generator (5 stars, last pushed 1mo ago), licensed MIT. It adds 1,813 tokens to every session, about $0.0091 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.