aiops: Instructions file for Codex

AGENTS.md

aiops AGENTS.md is an instructions file for Codex, OpenCode from yugasun/aiops. It costs 2,067 tokens per session, scanned A, original, Apache-2.0.

Project instructions for aiops, a system of agent definitions and task workflows. They emphasize making the smallest change needed and define how different task types move through review, testing, and delivery.

In plain words
What is it for?
Use them when planning or implementing aiops changes. They cover lean coding decisions, task-based agent dispatch, testing-driven development (TDD), pruning, review, and when to commit changes.
Why use it?
They help an agent avoid unnecessary code and follow the project's expected sequence for features, bugs, prototypes, and architecture work.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is yugasun/aiops's own configuration. It tells Codex and OpenCode how to work on aiops 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 aiops configures →

Reuse

Borrowing it

Nothing to install: this file belongs to yugasun/aiops. 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/yugasun/aiops/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/yugasun/aiops

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/yugasun/aiops/agents-md/github.svg)](https://agentmods.dev/instructions/yugasun/aiops/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/yugasun/aiops/agents-md"><img src="https://agentmods.dev/badge/instructions/yugasun/aiops/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 aiops AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/yugasun/aiops/agents-md"><img src="https://agentmods.dev/badge/instructions/yugasun/aiops/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,067 This file is loaded in full into every session.
When invoked 2,067 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.02067 $0.02067
Opus 5.5 $0.00827 $0.00827
Sonnet 5.5 $0.00413 $0.00413
Haiku 4.5 $0.00207 $0.00207

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

Security

Grade A, and why

aiops 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 2mo 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 · 216 lines

How it starts

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

aiops — Agent Definitions

The smallest working change. Skip what is not needed.

Lean Discipline

Before writing any code, stop at the first rung that holds:

Stop at the first rung that holds:

  1. Does this need to exist? (YAGNI)
  2. Stdlib does it?
  3. Native platform feature?
  4. Already-installed dependency?
  5. One line?
  6. Minimum code that works

Rules: No unrequested abstractions. Deletion over addition; shortest working diff. Mark deliberate shortcuts with // lean: <ceiling and upgrade path>.

Never cut: Trust-boundary validation, data-loss prevention, security, accessibility, explicitly requested behavior.

Delivery Sequence

Inside /aiops-implement: lean ladder → /tdd → /prune → /review → commit only on user approval.

Dispatch by Task Type

Task type Grill Prototype verdict Ends at
Feature yes only if /prototype ran /gitops
Feature + UI yes only if /prototype ran /gitops
Bug no no /gitops
Incoming conditional no /gitops
Architecture health yes (you pick the item) only if /prototype ran /gitops
Prototype — — VERDICT.md
New personal skill yes — new SKILL.md

Agents

architect

Role: alignment Outputs: .scratch//NOTES.md, .scratch//tech-spec.md

你是系统架构师。专注于问题空间理解和设计方案探索,输出清晰的设计决策供下游 agent 消费。你不急于写代码,而是确保方向正确。

Skills:

  • /explore — 自由探索,讨论想法和权衡,不产生文件
  • /grilling — 深度提问,暴露隐含假设
  • /grill-with-docs — 带领域文档的 grill
  • /domain-modeling — 领域模型构建
  • /architect-design — 结构化设计过程:约束梳理 → 模块识别 → 接口设计 → 替代方案探索 → 规格产出
  • /improve-codebase-architecture — 架构健康扫描(Architecture health 任务类型使用)
  • /code-graph — 构建和查询代码图谱,为架构分析提供结构化数据

Phase dispatch: Flow Conductor 每次只执行当前 phase 对应的一个 skill。上表其余技能仅供专家直调(/aiops architect …),不要在同一次回复里混用多个 phase 技能。

Inputs:

  • 用户原始需求描述
  • .scratch/<feature>/CONTEXT.md(如存在,来自 /aiops-setup)
  • .scratch/<feature>/VERDICT.md(如存在,来自 Prototyper 的验证结论)

builder

Read the full file on GitHub · 216 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. 2mo ago First seen · 216 lines · 2,067 tokens per session scan A 53b324df3cd6

Subscribe to this mod's changes

aiops AGENTS.md is an instructions file published in the GitHub repository yugasun/aiops (4 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 2,067 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-31.

Related

aiops AGENTS.md compared with instructions from other repositories

aiops AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
aiops AGENTS.mdyugasun/aiopsInstructions file42mo agoApache-2.0A2,067Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode