zrlog AGENTS.md

zrlog AGENTS.md is an instructions file for Codex, OpenCode from 94fzb/zrlog. It costs 1,040 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

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/94fzb/zrlog/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.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.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,040 This file is loaded in full into every session.
When invoked 1,040 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.01040 $0.01040
Opus 5 $0.00520 $0.00520
Sonnet 5 $0.00208 $0.00208
Haiku 4.5 $0.00104 $0.00104

Measured 3d ago against content hash a88834011342, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 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 · 76 lines

How it starts

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

AGENTS.md

这份文档是 AI Agent 在 zrlog 主工程内工作的入口规则。进入本仓库后,先读本文件,再按任务打开 doc/pom.xmlzrlog-web/package/ 下的具体实现。

工程定位

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

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

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

目录职责

路径 职责
zrlog-web/ 主 Web 应用模块,负责应用启动、模块加载、运行配置和集成测试。
package/ 发布包组装模块,维护最终分发包结构和依赖拷贝规则。
bin/ 构建信息、构建元数据和发布辅助脚本。
shell/ 本地 Maven/版本脚本和运维辅助脚本。
conf/ 本地运行配置样例或调试配置,修改前确认不是用户本地状态。
doc/ 主工程开发、构建、安装、测试和发布文档。

必读文档

涉及跨仓库开发、验收或发布时,以 zrlog-ops 中的任务契约、验收 YAML 和发布规则为总入口。

构建与验证

常用命令:

mvn -q -DskipTests compile
mvn -q -pl zrlog-web -am test
mvn -q -DskipTests package

修改 zrlog-web 行为时至少运行 mvn -q -pl zrlog-web -am test。修改打包、依赖范围、release 脚本或启动 classpath 时,需要检查真实产物结构,不能只依赖 Maven 编译通过。

边界规则

  • zrlog 只做集成和打包,不拥有 admin/blog/install/base 的业务模型。
  • 修改内部依赖版本前,先确认对应子工程已经构建或发布了目标版本。
  • 正式 release ref 不能依赖 SNAPSHOT;开发和预览集成可以使用本地或远端 snapshot。
  • 变更模块 classpath、依赖 scope、package 配置或启动参数时,要验证最终包内 lib/、manifest、启动日志和模块发现结果。
  • 不提交本地 conf/db.propertiesconf/install.lock 或临时测试包。
  • 不为了主工程验证绕过 install 流程,预览包安装必须走真实安装接口。

AI 修改流程

  1. 先判断任务属于主工程集成、发布打包、启动加载,还是应该回到子工程实现。
  2. 读取当前 pom.xml、脚本和真实产物规则,不凭旧版本记忆修改依赖或包结构。
  3. 保留工作区已有用户改动,不 reset、restore 或覆盖无关文件。
  4. 修改跨仓库依赖时记录生产者、消费者和验证命令。
  5. 修改发布或打包逻辑时检查生成物,并清理 target、临时 zip、解压目录等产物。
  6. 最终回复说明改动边界、验证命令和未处理风险。

常见任务入口

任务 起点
调整启动或模块加载 zrlog-web/src/main/java
调整最终包结构 package/pom.xmlpackage/src
更新内部模块版本 pom.xml 的依赖和 dependencyManagement
修改构建元数据 bin/shell/doc/build_system_info.md
安装体验集成验证 zrlog-ops/acceptance/zrlog-preview-package-install.yaml

Read the full file on GitHub · 76 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 · 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 (402 stars, last pushed 10d ago), licensed Apache-2.0. It adds 1,040 tokens to every session, about $0.0052 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.

Related

Other instructions, from other repositories

microfeed AGENTS.md

AGENTS.md instructions for microfeed/microfeed, covering repository guidance, development workflow, instance management and cloudflare deployment, source architecture and theme repositories.

microfeed/microfeed · 2,529 tokens

microfeed CLAUDE.md

Claude Code instructions for microfeed/microfeed, a project described as: an agentic cms self-hosted on cloudflare, for podcasts, blogs, photos, videos, documents, and curated urls.

microfeed/microfeed · 56 tokens

appwrite AGENTS.md

AGENTS.md instructions for appwrite/appwrite, covering appwrite, commands, stack, layout and libraries.

appwrite/appwrite · 6,541 tokens

trigger.dev AGENTS.md

AGENTS.md instructions for triggerdotdev/trigger.dev, covering agents.md, build and development commands, build packages (required before running), verifying changes and apps and internal packages — use typecheck.

triggerdotdev/trigger.dev · 3,383 tokens

workflow AGENTS.md

AGENTS.md instructions for vercel/workflow, covering agent instructions, architecture, core components, workflow execution model and development commands.

vercel/workflow · 8,698 tokens

trigger.dev copilot-instructions.md

Copilot instructions for triggerdotdev/trigger.dev: This is the repo for Trigger.dev, a background jobs platform written in TypeScript. Our webapp at apps/webapp is a Remix 2.1 app that uses Node.js v20. Our SDK is an isomorphic TypeScript SDK at packages/trigger-sdk. Always prefer using isomorphic code like fetch…

triggerdotdev/trigger.dev · 140 tokens