Starcat: Instructions file for Codex

AGENTS.md

Starcat AGENTS.md is an instructions file for Codex, OpenCode from starcat-app/Starcat. It costs 8,202 tokens per session, scanned A, original, MIT.

A set of project rules for coding agents working on Starcat, including database-change rules, Git branch and worktree practices, and required project documentation.

In plain words
What is it for?
Use it to decide when coding may begin, how database changes must be added, how branches and worktrees are handled, and which release or documentation actions are restricted.
Why use it?
It prevents unsafe changes to released databases, stops agents from coding before approval, and limits actions such as publishing or changing protected progress records.

Instructions file for CodexOpenCode

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

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

Reuse

Borrowing it

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

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

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/starcat-app/starcat/agents-md"><img src="https://agentmods.dev/badge/instructions/starcat-app/starcat/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 8,202 This file is loaded in full into every session.
When invoked 8,202 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.08202 $0.08202
Opus 5.5 $0.03281 $0.03281
Sonnet 5.5 $0.01640 $0.01640
Haiku 4.5 $0.00820 $0.00820

Measured today against content hash 3f4169fcf969, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

Starcat 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 today.

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 · 464 lines

How it starts

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

AGENTS.md

本文档为跨 Agent 协作提供指导,确保多个 Agent 在本代码库工作时保持一致。


🚨 硬性铁律(每次写代码前必读,违反即返工)

⚠️ 【铁律 #1】本项目已发布正式版,有线上用户与本地数据。 ⚠️ 已随正式版发出的数据库 schema:变更必须追加 registerVN 迁移,禁止直接改已落地的 v1-initial,禁止要求用户删库重建。 ⚠️ 未发布功能开发期例外:可直接改该功能建表草稿 SQL + ensurePrelaunch* 补齐本机库;收口进正式版时压成单次 registerVN 并收口。依赖未建表的中间 migration 必须对「表不存在」no-op。 ⚠️ RAG 已于 2026-07-14 收口为 v7-knowledge-rag:禁止再回写 v1 草稿或启动期旁路补 RAG。 ⚠️ 应用层仍禁止堆叠无意义的「兼容旧 API / 双写旧字段 / 永久双轨」——废弃路径用迁移删掉或一次性替换,不要长期保留两套接口。 ⚠️ 看到代码层旧路径不再需要 → 直接删;已发布库的字段废弃 → 追加迁移处理,不要只改建表语句假装老用户会跟着变。

⚠️ 【铁律 #2】方案讨论 ≠ 动手许可。 ⚠️ dong4j 在反馈方案 / 修正理解 / 给出补充信息时,默认仍在讨论阶段。 ⚠️ 必须等 dong4j 明确说「开干 / 改吧 / GO / 动手 / 实施」等字眼,才能开始改代码;只要还在交换意见就只读不写。

⚠️ 【铁律 #3】禁止擅自执行打包 / 发布 / 上传脚本。 ⚠️ 除非 dong4j 在当前消息里明确要求执行,否则 Agent 只能修改脚本、写文档、给命令,不能执行 scripts/package-*、scripts/release-*、deploy.sh、notary 上传、App Store 上传、服务器上传等会生成或发布分发产物的命令。 ⚠️ 允许执行只读检查命令,例如 bash -n、git diff --check、codesign -d、PlistBuddy -c Print、dwarfdump --uuid。

⚠️ 【铁律 #4】禁止擅自改写 docs/功能实现总览.md。 ⚠️ dong4j 未口头 / 书面明确确认前,禁止对该文件做任何写入:含勾选 [x]、追加 / 改写 > 实现:、变更日志、进度仪表盘数字、新增 - [ ] / 技术债条目、改状态说明、删改正文、任何措辞润色。 ⚠️ 改完代码或其它文档 ≠ 可以同步改总览。 中间迭代、未验收、未确认的改动,一律不准往变更日志里塞条目;禁止连刷返工垃圾日志。 ⚠️ 允许且鼓励只读打开该文件做开工检查。 需要登记时:在回复里起草拟写入内容,等 dong4j 明确说「可以写总览 / 同步总览 / 记到总览 / 勾上」等之后再改文件。 ⚠️ dong4j 确认后写入时仍须遵守下文勾选与 > 实现: 格式(仅打勾不够)。

⚠️ 【铁律 #5】未经 dong4j 明确授权,禁止自行使用 Computer Use(GUI 桌面控制)。(2026-09-13 起生效) ⚠️ computer-use 系列能力(截屏、鼠标键盘、打开 / 操作应用窗口等)默认一律不用;Agent 不得自行判断「需要看界面」就调用。 ⚠️ 只读操作同样需要授权:包括获取应用 / 浏览器界面状态、读取辅助功能树(AX tree)、截屏;不得以「没有点击」「仅做验证」为由绕过,也不得换用脚本或其它工具执行等价的 GUI 自动化。 ⚠️ 排查 UI / 运行时问题默认只读代码 + Makefile 构建;确需操作屏幕时,先在回复里说明用途与操作范围,等 dong4j 明确说「可以用 computer use / 授权操作屏幕」后再用。 ⚠️ 本铁律与铁律 #2 同层:dong4j 描述现象、贴截图 ≠ 授权操作屏幕,截图用文字分析即可。


🌿 Git 分支与 Worktree(强制)

所有分支与 worktree 的创建、切换、同步、合并和删除,必须遵循 docs/5-规范/Git-分支与Worktree规范.md。

  • 涉及分支/worktree 操作前,先读取根目录 BRANCH.md,再用 Git 命令核对真实 refs、提交关系和 worktree 归属。
  • 创建、切换或恢复长期分支后,必须向 dong4j 说明当前分支、用途、基线、worktree、状态和后续归宿。
  • 创建、合并、停放、废弃或删除长期分支/worktree 时,必须在同一任务中同步更新 BRANCH.md。
  • 删除前必须检查独有提交、Git 合并关系、语义覆盖和 worktree 脏状态;未审查分支禁止直接删除。
  • 未经 dong4j 明确授权,不得 push、删除远端分支、强制删除 worktree 或改写共享历史。

Read the full file on GitHub · 464 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. today Changed · +1 lines · +146 tokens per session 3f4169fcf969
  2. 11d ago Changed · +7 lines · +255 tokens per session de69b63a8b46
  3. 1mo ago Changed · +1 lines · +96 tokens per session ac9005aa2942
  4. 1mo ago Changed · +6 lines · +266 tokens per session 59b1257555bf
  5. 1mo ago Changed · +20 lines · +362 tokens per session 167294861d28
  6. 1mo ago First seen · 429 lines · 7,077 tokens per session scan A 5ce57a3833c7

Subscribe to this mod's changes

Starcat AGENTS.md is an instructions file published in the GitHub repository starcat-app/Starcat (211 stars, last pushed today), licensed MIT. It adds 8,202 tokens to every session, about $0.0328 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

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,649 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,549 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens