AGENTS.md@vegaA

AGENTS.md@vega from openbkn-ai/bkn-foundry is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add openbkn-ai/bkn-foundry/vega/AGENTS.md@git:20261105.87fb895

Pins git:20261105.87fb895 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
openbkn-ai/bkn-foundry
Path
vega/AGENTS.md
Versions recorded
14
Latest version
git:20261105.87fb895, committed Nov 5, 2026
First version recorded
Sep 22, 2026
Size
15,520 bytes
Repository stars
1,211
License
a license file GitHub does not identify

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# VEGA Agent 协作规范

本文件适用于 `vega/` 子系统。开始工作前必须先读取仓库根目录的 `AGENTS.md`、相关 `rules/`,以及目标目录下更具体的 `AGENTS.md` 或 `CLAUDE.md`。规则冲突时,以更具体目录的规则为准。

## 强制语言规范

- 与用户的沟通、计划、进度、分析、结论和交付说明必须使用中文。
- 日志文本遵循目标模块既有风格,同一调用链内不得混用语言;除非兼容性或既有约定要求,不得仅为翻译日志制造无关 diff。
- 用户明确要求其他语言,或外部制品规范强制使用其他语言时,可以例外,并在交付说明中注明原因。

## 工作方式

1. 编写代码前,先用中文说明实现方法;需要实质性判断或范围选择时,等待用户批准。
2. Plan 模式默认给出验收清单和失败条件。
3. 需求中的歧义会实质影响范围、行为或风险时,先提出澄清问题;其余情况说明合理假设后继续。
   用户明确要求先讨论时,仅做讨论和只读核对,直到用户明确要求开始或修复后才修改文件。
4. Bug 修复应先增加或更新能够复现问题的回归测试,再完成修复直至测试通过;确实无法先写测试时必须说明原因。
5. 修改完成后,列出相关边界场景、已覆盖测试和仍存在的测试缺口。
6. 预计修改超过 3 个文件时,先说明拆分方案和文件范围,避免把无关重构混入同一变更。
7. 用户纠正工作方式后,应反思原因并把可长期复用的约束更新到相应 `AGENTS.md`,但仍须先提供 diff 供 review。
8. 回答历史工作或决策问题前,必须先查阅仓库记录、Issue、PR 或可用的记忆文件,不得仅凭印象回答。
9. 完成修改和验证后先向用户提供 diff;未经明确批准,不得 commit、push、创建或更新 PR,也不得写回 Issue/PR。

## 工程原则

- 未经用户明确允许,不新增或扩展 OpenSearch script;一般修复授权不包含脚本授权。确需使用时,先说明执行位置和性能影响并等待明确许可。
- 新增源端逻辑类型不自动扩展 Dataset 的允许类型。本地索引将源类型存为既有物理类型时,在查询 schema 副本中统一转换并复用既有操作规则,不为源类型逐算子追加索引特判。
- 原生 Index 的扫描 schema 直接用于保存和查询校验;`SchemaForQuery` 只用于非 Index 资源查询托管本地索引时的投影,不为缺少实际来源依据的 `date_nanos` 等原始类型追加转换特判。

- 公共过滤输入契约变更须核对所有连接器及本地索引通道;回归测试应验证解析后的绑定值、时区语义和错误分类,不能仅凭复现来源的单一连接器测试通过宣称契约统一。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add openbkn-ai/bkn-foundry/vega/AGENTS.md@sha256:44243510d7dd0780

The line at the top of this page pins the label git:20261105.87fb895, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tvsvzs4vmgacy6vt.svg)](https://markdownregistry.com/a/art_tvsvzs4vmgacy6vt)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 14 versions of this file, between Sep 22, 2026 and Nov 5, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261105.87fb895 latest2026-11-05 87fb895 15,520 BA view · diff
git:20261103.c87bd4c2026-11-03 c87bd4c 15,173 BA view · diff
git:20261103.12d33cf2026-11-03 12d33cf 14,984 BA view · diff
git:20261102.421385e2026-11-02 421385e 14,190 BA view · diff
git:20261102.bf44d572026-11-02 bf44d57 12,407 BA view · diff
git:20261029.1ff10022026-10-29 1ff1002 12,318 BA view · diff
git:20261022.bd9a3942026-10-22 bd9a394 12,115 BA view · diff
git:20261022.8373e2f2026-10-22 8373e2f 11,920 BA view · diff
git:20261020.d36140c2026-10-20 d36140c 11,683 BA view · diff
git:20261019.70666612026-10-19 7066661 11,093 BA view · diff
git:20261010.7e619b72026-10-10 7e619b7 10,625 BA view · diff
git:20260928.c4aa57b2026-09-28 c4aa57b 10,473 BA view · diff
git:20260922.010fbb02026-09-22 010fbb0 10,204 BA view · diff
git:20260922.d8980212026-09-22 d898021 10,196 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (15520 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

openbkn-ai/bkn-foundry · 1,211 stars · license a license file GitHub does not identify · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tvsvzs4vmgacy6vt
GET https://markdownregistry.com/api/v1/resolve?ref=openbkn-ai/bkn-foundry/vega/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/44243510d7dd0780c72de706e5c83fbc44a0542aba94d996e347becd8380d369

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from openbkn-ai/bkn-foundry

AGENTS.md AGENTS.md file
openbkn-ai/bkn-foundry · AGENTS.md
git:20260930.376c561 · audit A · 1,211 stars
CLAUDE.md@adp CLAUDE.md file
openbkn-ai/bkn-foundry · adp/CLAUDE.md
git:20260407.4ae969e · audit F · 1,211 stars
AGENTS.md@adp/bkn AGENTS.md file
openbkn-ai/bkn-foundry · adp/bkn/AGENTS.md
git:20261102.1f029b6 · audit A · 1,211 stars
exchange-recovery SKILL.md skill
openbkn-ai/bkn-foundry · adp/bkn/bkn-backend/server/bkn-specification/examples/exchange-recovery/SKILL.md
git:20260708.acb43ca · audit C · 1,211 stars
k8s-network SKILL.md skill
openbkn-ai/bkn-foundry · adp/bkn/bkn-backend/server/bkn-specification/examples/k8s-network/SKILL.md
git:20260708.acb43ca · audit C · 1,211 stars
mock_system SKILL.md skill
openbkn-ai/bkn-foundry · adp/bkn/bkn-backend/server/bkn-specification/examples/mock_system/SKILL.md
git:20260708.acb43ca · audit C · 1,211 stars
supplychain-hd SKILL.md skill
openbkn-ai/bkn-foundry · adp/bkn/bkn-backend/server/bkn-specification/examples/supplychain-hd/SKILL.md
git:20260708.acb43ca · audit C · 1,211 stars
k8s-network SKILL.md skill
openbkn-ai/bkn-foundry · adp/bkn/bkn-backend/tests/integration_tests/bkn/helpers/examples/k8s-network/SKILL.md
git:20260407.4ae969e · audit C · 1,211 stars
AGENTS.md@adp/execution-factory/operator-integration AGENTS.md file
openbkn-ai/bkn-foundry · adp/execution-factory/operator-integration/AGENTS.md
git:20261028.1bc5a7e · audit A · 1,211 stars
AGENTS.md@data-migrator AGENTS.md file
openbkn-ai/bkn-foundry · data-migrator/AGENTS.md
git:20261012.191928e · audit F · 1,211 stars
CLAUDE.md@data-migrator CLAUDE.md file
openbkn-ai/bkn-foundry · data-migrator/CLAUDE.md
git:20260602.4cc9194 · audit F · 1,211 stars
demand-deliverability-assessment SKILL.md skill
openbkn-ai/bkn-foundry · docs/templates/skill-package/examples/demand-deliverability-assessment/SKILL.md · Use when a user asks whether a product demand (an existing forecast or a new order) can be delivered on knowledge…
git:20261101.d3e6fca · audit A · 1,211 stars

Every file in openbkn-ai/bkn-foundry

Browse by kind, by grade A, or by owner.