areco AGENTS.md

areco AGENTS.md is an instructions file for Codex, OpenCode from bb4407777/areco. It costs 1,350 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for areco, a multi-agent software project. They describe handoffs, testing, deployment, file organization and rules for keeping desktop and mobile changes aligned.

In plain words
What is it for?
Use them when changing areco to run its tests, check both desktop and mobile interfaces, document fixes, inspect real session data, commit work, and record verification and rollback details.
Why use it?
They help coding agents preserve the project’s operating practices and leave a traceable record of changes. This reduces regressions that are hard to attribute or repeat across multiple agents.

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

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/bb4407777/areco/agents-md.svg)](https://agentmods.dev/instructions/bb4407777/areco/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/bb4407777/areco/agents-md"><img src="https://agentmods.dev/badge/instructions/bb4407777/areco/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,350 This file is loaded in full into every session.
When invoked 1,350 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.01350 $0.01350
Opus 5 $0.00675 $0.00675
Sonnet 5 $0.00270 $0.00270
Haiku 4.5 $0.00135 $0.00135

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

Security

Grade A, and why

areco 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 · 61 lines

How it starts

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

AGENTS.md(areco 仓内 agent 行为约束)

本仓由多 agent(Claude Code / Codex / WorkBuddy / Kimi CLI …)接力开发。 每条规则都踩过坑,别删,只增补。

交接纪律(2026-07-19 定)

  1. 每棒收尾前必须 git commit——工作区不过夜。攒一天 20+ 文件未提交, 出了回归无法归因是谁哪一棒引入的(当日桥水绑定/红绿灯两起回归即教训)。
  2. 行为变更必须拿真实数据自验再交接:跑一遍真实看板/真实 transcript 目录 (~/.claude/projects~/.codex/sessions~/.codebuddy/projects), 单测全绿不算完——严格绑定器单测全过、一碰真实软链双候选就拒绑即教训。
  3. 交接文件(data/handoff/)写清:本棒 commit 范围、改了什么行为、 有什么没验证到。
  4. 每个新功能/修复 = 一份独立工程档案(2026-07-27 高律师定):除「交接」用途外, 功能/修复本身要有一份独立档案 data/handoff/YYYY-MM-DD-<主题>.md,写清根因/动机、 改了哪些代码(文件:行)、怎么验证(测试/实测)、回滚方法、部署门槛、未办/风险。 下次同类故障先查档案 + git log,不从零排查——「不知道哪次修改把原有功能改没了」 即靠此追溯。无档案 = 没干完。 示范:data/handoff/2026-07-27-claude-transcript-binding-fix.md

本仓操作

  • 桌面/手机双端同步上线(2026-07-22 高律师定):任何 UI 功能改动必须先想清 两端的落点——桌面侧栏(SessionSidebar)与手机看板(DashboardView 卡片流)是 两套组件,改一套不等于另一套生效。共用逻辑抽成公共模块(如 utils/sessionGroups), 不许复制两份漂移;交付前两端各过一遍。
  • 测试:npm test(tsx --test,含服务端/客户端/共享层);类型检查即构建前置。
  • 部署:./start.sh restart(launchd com.areco 已接管,脚本自动转发 kickstart); 生产 8790 可能有用户在舱内开着的会话,重启前先 /api/sessions 看一眼。
  • shell 脚本:macOS 系统 bash 3.2 下 $VAR 后紧跟中文/全角字符会把首字节 粘进变量名(set -u 直接炸)——变量后接 CJK 一律写 ${VAR}
  • config.jsondata/bin/ 是 gitignore 的本机私有物,不入仓。

复用模式清单(2026-07-24 高律师定:一套更换,改一处必同步)

这些是仓里已经沉淀的共用模块/版式约定。新功能先查这里有没有现成的, 不许复制第二份;改版式/判断逻辑时按「同步面」整组改,漏一处就是回归。

消息气泡版式(三处同构,改版式必须整组改)

  • 统一结构:.msg-meta(发送者名/模板名,泡泡上方)→ .bubble.msg-foot (左「📋 复制 / ✓ 已复制」,右完整时间 fmtFullTime)。
  • 落点:ChatMessage.vue(对话模式 + 历史日志页共用组件,模板名走 agentLabel prop) 与 GroupChatView.vue 消息块(项目,self 消息 foot 整体右对齐)。

utils/format.ts(会话展示的判断与格式化,唯一出处)

  • templateLabel / templateColor:模板名与颜色(模板已删有兜底)。
  • chatCapable / sessionEntryPath:会话有无对话视图、按偏好算落点路由—— 看板点卡片、侧栏、新建会话三处共用,禁止在调用处重写判断
  • fmtFullTime:气泡右下角完整时间,两端统一格式。
  • trafficColor / statusTagText:红绿灯与状态文案。

其他共用件

  • utils/sessionGroups.ts:桌面侧栏与手机看板的项目分组规则(双端同源)。
  • utils/clipboard.ts copyPlainText:双通道复制(气泡/项目消息同用)。
  • utils/filelinks.ts + FilePreview.vue:正文里文件路径 → chip 预览。
  • stores/ui.ts:本机 UI 偏好(localStorage areco-ui)。加新偏好 = 加字段 + DEFAULT_PREFS + persist() + setter,设置页用「对话模式」卡片的 pref-row 样式挂开关。
  • SpawnDialog.vuespawned 事件必须传完整 SessionSummary——store 靠 ws 推送, spawn 返回瞬间 byId 查不到新会话(2026-07-23 落点判断失效即此坑)。
  • 组件:TypingIndicator / ViewModeSwitch / PromptBar / MobileKeyBar 全局复用。

Read the full file on GitHub · 61 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 · 61 lines · 1,350 tokens per session scan A 7855ab01b6be

Subscribe to this mod's changes

areco AGENTS.md is an instructions file published in the GitHub repository bb4407777/areco (2 stars, last pushed 22d ago), licensed Apache-2.0. It adds 1,350 tokens to every session, about $0.0068 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-31.

Related

Other instructions, from other repositories