zrlog: Instructions file for Codex

AGENTS.md

zrlog AGENTS.md is an instructions file for Codex, OpenCode from 94fzb/zrlog. It costs 2,070 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for ZrLog, an application assembled from several Java and web modules. They explain each directory, required documents, Maven commands, and rules for keeping business code in its proper subproject.

In plain words
What is it for?
Use them when changing application integration, dependencies, packaging, startup configuration, release files, or tests, and when verifying the resulting ZIP, WAR, Docker, or other distribution packages.
Why use it?
They help an agent understand that this repository mainly integrates and packages components, reducing the risk of changing the wrong project or trusting an incomplete build check.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md; mentions Codex.

This is 94fzb/zrlog's own configuration. It tells Codex and OpenCode how to work on zrlog itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything zrlog configures →

Reuse

Borrowing it

Nothing to install: this file belongs to 94fzb/zrlog. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/94fzb/zrlog/master/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/94fzb/zrlog

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/94fzb/zrlog/agents-md/github.svg)](https://agentmods.dev/instructions/94fzb/zrlog/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/94fzb/zrlog/agents-md"><img src="https://agentmods.dev/badge/instructions/94fzb/zrlog/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for zrlog AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/94fzb/zrlog/agents-md"><img src="https://agentmods.dev/badge/instructions/94fzb/zrlog/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,070 This file is loaded in full into every session.
When invoked 2,070 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.02070 $0.02070
Opus 5.5 $0.00828 $0.00828
Sonnet 5.5 $0.00414 $0.00414
Haiku 4.5 $0.00207 $0.00207

Measured 2d ago against content hash ce8d4bf5d8fb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

zrlog 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.

AGENTS.md · 111 lines

How it starts

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

AGENTS.md

这份文档是 AI Agent 在 zrlog 主工程内工作的入口规则。先读本文件,再按任务打开具体实现。若本地存在 .codex/AGENTS.md ,同时读取其中的工作区约定;该目录不提交到仓库。

工程定位

zrlog 是 ZrLog 的主集成和打包工程,主要负责:

  • 组装 zrlog-base、zrlog-admin-web、zrlog-blog-web、zrlog-install-web 等独立产物。
  • 提供最终应用的启动入口、运行配置和模块加载。
  • 产出 Zip、WAR、Docker、Native Image、Serverless 等发布形态所需的工程结构。
  • 管理用户安装部署文档、构建脚本、release/update manifest 和包内资源。

不要把后台、前台、安装或基础库的业务实现长期放在本仓库。功能逻辑应回到对应子工程修改,再由 zrlog 更新依赖版本并做集成验证。

目录职责

路径 职责
zrlog-web/ 主 Web 应用模块,负责应用启动、模块加载、运行配置和集成测试。
package/ 发布包组装模块,维护最终分发包结构和依赖拷贝规则。
bin/ 构建信息、构建元数据和发布辅助脚本。
shell/ Java/Native 组包、CI、发布与校验脚本;Docker 自动化统一放在 shell/docker/。
docker/ Compose、环境变量样例、镜像定义与用户说明;resolve-native-package.sh 是下载型 Dockerfile 的构建输入。
conf/ 本地运行配置样例或调试配置,修改前确认不是用户本地状态。
doc/ 用户安装、Compose 部署和制品验证说明;build_system_info.md 是构建生成的包内信息。

协作约定

涉及跨仓库开发、验收或发布时,先读取工作区提供的任务契约、验收要求和发布规则。仓库内文档面向产品使用者,本文件只保留职责边界、源码入口和必要的验证约束。

构建与验证

常用命令:

./mvnw -q spotless:apply
./mvnw -q spotless:check
./mvnw -q -DskipTests compile
./mvnw -q -U -pl zrlog-web -am test
./mvnw -q -DskipTests package

Java 源码统一使用 Google Java Format AOSP 四空格风格。格式化命令在仓库根目录使用 JDK 21+ 执行; java-format profile 会自动启用并在 validate 阶段检查格式,CI 的 Java Format 工作流使用 JDK 21 独立检查。

修改 zrlog-web 行为时至少运行 ./mvnw -q -U -pl zrlog-web -am test。修改打包、依赖范围、release 脚本或启动 classpath 时,需要检查真实产物结构,不能只依赖 Maven 编译通过。Docker 离线契约与 Compose 配置检查脚本在 shell/docker/;工作流契约检查为 python3 shell/ci/test-package-workflows.py。

预览、候选、正式包和 Docker 只有一个入口 .github/workflows/build-package.yml,渠道共用构建与证明步骤。 所有触发默认构建全部包类型和支持平台,分支只选择预览/正式渠道,不缩减打包矩阵。 手动排查可显式选择包类型或设置 full_platforms=false;未显式选择时按完整矩阵处理。 平台矩阵以该工作流为准,失败恢复重跑对应 job。 不得另写工具链与打包步骤;验收消费已归档的实际包并核对 source/producer/SHA-256。

Read the full file on GitHub · 111 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 Changed · +5 lines · +92 tokens per session ce8d4bf5d8fb
  2. 3d ago Changed · -3 tokens per session 6cd19d1d7c7f
  3. 17d ago Changed · +9 lines · +38 tokens per session 349fcdb1ebdf
  4. 20d ago Changed · +8 lines · +351 tokens per session 1ea23875248f
  5. 21d ago Changed · +4 lines · +175 tokens per session e472a88ab129
  6. 23d ago Changed · +1 lines · +103 tokens per session d4c865adecc6
  7. 1mo ago Changed · +4 lines · +79 tokens per session ac69e144ed88
  8. 1mo ago Changed · +4 lines · +195 tokens per session 5086f007d1ee
  9. 2mo ago First seen · 76 lines · 1,040 tokens per session scan A a88834011342

Subscribe to this mod's changes

zrlog AGENTS.md is an instructions file published in the GitHub repository 94fzb/zrlog (407 stars, last pushed yesterday), licensed Apache-2.0. It adds 2,070 tokens to every session, about $0.0083 per session on Opus 5.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.

Related

zrlog AGENTS.md compared with instructions from other repositories

zrlog AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
zrlog AGENTS.md94fzb/zrlogInstructions file407yesterdayApache-2.0A2,070Codex, OpenCode
vibetags com-example-service-OrderService.instructions.mdPIsberg/vibetagsInstructions file25todayMITA553GitHub Copilot
vibetags com-example-security-SecurityConfig.instructions.mdPIsberg/vibetagsInstructions file25todayMITA281GitHub Copilot
vibetags com-example-service-TransactionalPaymentService.instructions.mdPIsberg/vibetagsInstructions file25todayMITA104GitHub Copilot
vibetags com-example-config-AsyncTestConfig.instructions.mdPIsberg/vibetagsInstructions file25todayMITA82GitHub Copilot
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode