AGENTS.md@packages/capability-sdkA
AGENTS.md@packages/capability-sdk from maomaochong-ai/open-astravia is an AGENTS.md file: the standing instructions coding agents read in that repo.
mdr add maomaochong-ai/open-astravia/packages/capability-sdk/AGENTS.md@git:20261001.0ce1911Pins git:20261001.0ce1911 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- AGENTS.md file
- Repository
- maomaochong-ai/open-astravia
- Path
packages/capability-sdk/AGENTS.md- Versions recorded
- 4
- Latest version
- git:20261001.0ce1911, committed Oct 1, 2026
- First version recorded
- Aug 11, 2026
- Size
- 3,077 bytes
- Repository stars
- 39
- License
- Apache-2.0
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
# Team: Capability 本文件适用于 `packages/capability-sdk/` 及其全部子目录。 ## 必读文档 修改 Capability Token、Schema、Catalog 或 Access 合同前，必须先阅读： - [`docs/contracts-and-host-integration.md`](docs/contracts-and-host-integration.md) - [`../../docs/capabilities/README.md`](../../docs/capabilities/README.md) ## 职责范围 本包只定义宿主和上层系统无关的 Capability 端口：稳定 Token、输入输出 Schema、Catalog、错误及 Grant/Session 合同。具体 Provider、系统权限映射、Session 生命周期、Electron/DOM/Router 实现和组合根 属于消费方。 ## 边界规则 - 不得因为本包不引用 `desktop`，就判定 Desktop 行为不能成为 Capability。正确结构是本包定义端口， `desktop` 导入 Token 并注册 Provider 实现。 - Capability 必须表达稳定的 query/command，输入输出必须可由现有 Schema 机制描述并在运行时校验。 React 组件、回调、DOM 节点、Router 实例和其他进程内对象不得进入 Capability 输入输出。 - Foundation 只承载与 Astravia 产品领域无关的平台原语；项目、会话等稳定应用服务属于 Domain。 导航等 Renderer 行为只有形成跨系统稳定合同并完成独立评审后才可提升为 Domain Capability； Plugin/Theme/Action 的 contribution、manifest、生命周期和系统权限语义不属于通用 Capability 合同。 - 本包不得新增 Plugin、Theme、Action 或某个宿主专用 Adapter，也不得出现其 manifest、permission、 trust level、激活状态或生命周期分支。上层系统在自己的集成目录中依赖本包并创建精确 Grant。 - 包根和公开子路径只导出稳定合同，不提供 `internal/*-adapter` 例外入口。 - Capability ID、layer、publisher、错误码和约束必须使用本包常量或 Token，不得在消费方重复手写字符串。 - 新增或修改 Token 时，同步更新所属聚合导出、Catalog 生成事实源和合同测试；不得手工编辑生成的 …
Read the whole file at its exact version.
How to install
mdr add maomaochong-ai/open-astravia/packages/capability-sdk/AGENTS.md@sha256:baa074eedc95c388The line at the top of this page pins the label git:20261001.0ce1911, 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.
[](https://markdownregistry.com/a/art_4l2ftlff2sti47zg)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Aug 11, 2026 and Oct 1, 2026, about one every 17 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261001.0ce1911 latest | 2026-10-01 | 0ce1911 | 3,077 B | A | view · diff |
| git:20260818.995e8e1 | 2026-08-18 | 995e8e1 | 3,074 B | A | view · diff |
| git:20260811.89df0a9 | 2026-08-11 | 89df0a9 | 3,082 B | A | view · diff |
| git:20260811.fa7275c | 2026-08-11 | fa7275c | 3,085 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (3077 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
maomaochong-ai/open-astravia · 39 stars · license Apache-2.0 · pushed 2026-11-01 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_4l2ftlff2sti47zg GET https://markdownregistry.com/api/v1/resolve?ref=maomaochong-ai/open-astravia/packages/capability-sdk/AGENTS.md GET https://markdownregistry.com/api/v1/blob/baa074eedc95c3880c3e347d7ea5452ec5a69f2f616d8e3d50c8ded7a3c3ccbe
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.