LinkWork AGENTS.md

Repository instructions for LinkWork, a project with Java-based backend and scheduling components. They define bilingual documentation, security, design-documentation, error-handling, and reuse rules.

In plain words
What is it for?
Use them when changing LinkWork code, documentation, architecture, security behavior, exception handling, or shared project components.
Why use it?
They establish project-wide practices that help keep designs documented, user-facing material available in Chinese, and failures visible. They also discourage unsafe changes and duplicated utilities.

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

Made for: Codex, OpenCode.

Per session 1,632 This file is loaded in full into every session.
When invoked 1,632 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.01632 $0.01632
Opus 5 $0.00816 $0.00816
Sonnet 5 $0.00326 $0.00326
Haiku 4.5 $0.00163 $0.00163

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

Security

Grade A, and why

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

LinkWork — AGENTS.md

AI Agent 协作入口文档。所有参与本项目的 AI Agent 必须先阅读此文件。


核心原则 (Core Principles)

  1. 文档必须包含中文 (Bilingual Docs):所有面向用户的文档(README、docs/、注释中的关键说明)必须提供中文内容,可采用中英双语或纯中文。治理文件(CONTRIBUTING、CODE_OF_CONDUCT、SECURITY)保持英文。
  2. 安全第一 (Security First):零容忍安全漏洞。容器逃逸、注入、越权等问题必须立即修复。详见 SECURITY.md
  3. Design First:修改代码前先更新 docs/ 下的设计文档。文档是唯一的真理来源。
  4. 不吞异常 (No Silent Failures):精准捕获异常,禁止空 catch;兜底层必须打日志 + 告警。
  5. 不重复造轮子 (Anti-Wheel-Reinventing):优先使用项目内已有工具类和组件。

项目结构 (Project Structure)

LinkWork/
├── AGENTS.md                 # 本文件 — Agent 协作入口
├── README.md                 # 英文项目介绍
├── README_zh-CN.md           # 中文项目介绍
├── CONTRIBUTING.md           # 贡献指南
├── CODE_OF_CONDUCT.md        # 行为准则 (Contributor Covenant v2.1)
├── SECURITY.md               # 安全漏洞报告流程
├── CHANGELOG.md              # 变更日志
├── LICENSE                   # Apache License 2.0
├── .github/                  # GitHub 基础设施
│   ├── ISSUE_TEMPLATE/       # Issue 模板 (bug / feature)
│   ├── pull_request_template.md
│   └── CODEOWNERS
├── backend/                  # [submodule] linkwork-backend — Spring Boot 后端应用
├── linkwork-server/          # [submodule] 核心调度引擎 (Java)
├── linkwork-executor/        # [submodule] 安全执行器 (Go)
├── linkwork-agent-sdk/       # [submodule] Agent 运行时 (Python)
├── linkwork-mcp-gateway/     # [submodule] MCP 工具网关 (Go)
├── linkwork-web/             # [submodule] 前端参考实现 (Vue 3)
├── docs/                     # 项目文档(中文,_zh-CN 后缀)
│   ├── README_zh-CN.md       # 文档导航索引
│   ├── quick-start_zh-CN.md  # 快速开始
│   ├── concepts/             # 核心概念
│   │   ├── workstation_zh-CN.md       # 岗位模型
│   │   ├── skills_zh-CN.md            # Skills 系统
│   │   ├── mcp-tools_zh-CN.md        # MCP 工具
│   │   └── harness-engineering_zh-CN.md  # Harness Engineering
│   ├── architecture/         # 架构设计
│   │   ├── overview_zh-CN.md          # 系统架构总览
│   │   ├── components_zh-CN.md        # 核心组件
│   │   ├── data-flow_zh-CN.md         # 数据流与实时通信
│   │   └── security_zh-CN.md          # 安全架构
│   ├── guides/               # 使用指南
│   │   ├── deployment_zh-CN.md        # 部署指南
│   │   └── extension_zh-CN.md         # 扩展开发指南
│   └── examples/             # 实践案例
└──     └── literature-tracker_zh-CN.md  # 文献追踪员示例

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 First seen · 111 lines · 1,632 tokens per session scan A e99604f4adc0

Subscribe to this mod's changes

LinkWork AGENTS.md is an instructions file published in the GitHub repository momotech/LinkWork (117 stars, last pushed 5mo ago), licensed Apache-2.0. It adds 1,632 tokens to every session, about $0.0082 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.