briefbound-api-contract SKILL.md skillA

briefbound-api-contract from ccdawn/codex-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ccdawn/codex-skills/briefbound-api-contract@git:20260920.280b6d2

Pins git:20260920.280b6d2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ccdawn/codex-skills
Path
skills/engineering/briefbound-api-contract/SKILL.md
Versions recorded
1
Latest version
git:20260920.280b6d2, committed Sep 20, 2026
Size
3,922 bytes
Repository stars
6
License
MIT

Use when a change touches an external contract surface - REST/GraphQL endpoints, request/response schemas, DB schema, events, or CLI arguments - and needs design, breaking-change analysis, versioning, or a migration path; do not use for general implementation planning, code review, or feature coding.

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

# Briefbound API Contract

## 目标

保护对外契约面:接口、schema、事件和 CLI 参数的每一次变更都有兼容性判定、版本策略和消费者影响评估。它负责契约设计与审查,不负责实施方案、代码实现或 PR 审查。

## Briefbound task contract

- Context Boundary: 契约面清单(端点/schema/事件/参数)、现有版本与消费者、拟议变更、兼容性约束和弃用政策。
- Output Contract: 契约设计或变更说明、兼容性判定、破坏点清单、版本与迁移路径、消费者影响。
- Allowed Action: 只读审查现有契约并起草新契约;不直接修改实现代码或数据库数据。
- Success Evidence: 每个破坏点有对照依据(旧定义 vs 新定义);消费者影响可枚举;迁移步骤可执行。
- Stop Condition: 消费者清单不明、契约事实源缺失、变更目标与业务约束冲突,或需先做产品决策。
- Route Out: 实施方案 `briefbound-planning`;契约测试落地 `briefbound-test-strategy`;PR 审查 `briefbound-pr-review`;`briefbound-router` 或 BLOCKED。

## 统一调用契约

- 只处理 Briefbound task contract 范围;不匹配时回 `briefbound-router` 或更具体 owner,复合任务不吞其他 owner。
- 用户可见内容默认中文,先给判定结论再列破坏点;契约字段、类型、状态码和版本号保留原文;Route Out 仅以 Briefbound task contract 为准,有自然闸门时末行 `下一步建议: <一个具体动作>`,否则继续已授权工作。

## 激活闸门

变更触及对外可见的契约面,或用户要求 API/schema/事件设计评审、兼容性评估、版本或迁移规划时进入。内部函数签名、模块边界和私有数据结构不进本 skill;一般实施方案交 `briefbound-planning`。

## 破坏性识别

逐项检查拟议变更,以下均为 BREAKING(对至少一个真实消费者):

- 删除或重命名字段、端点、事件或参数。
- 收紧类型/枚举/取值范围/必填约束。
- 改变默认值、单位、排序、幂等或错误语义。
- 放宽输入(接受更多)通常兼容;收紧输入必破坏。
- 改状态码、错误结构或分页语义。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ccdawn/codex-skills/briefbound-api-contract@sha256:9703c8f97d22c8a3

The line at the top of this page pins the label git:20260920.280b6d2, 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_invhvsqlxcp7ogfb.svg)](https://markdownregistry.com/a/art_invhvsqlxcp7ogfb)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 20, 2026.

versioncommittedcommitsizeaudit
git:20260920.280b6d2 latest2026-09-20 280b6d2 3,922 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3922 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

ccdawn/codex-skills · 6 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_invhvsqlxcp7ogfb
GET https://markdownregistry.com/api/v1/resolve?ref=ccdawn/codex-skills/briefbound-api-contract
GET https://markdownregistry.com/api/v1/blob/9703c8f97d22c8a3fc81ea4c3d404d1b45d0549a172ba27efaffa5f9cfc44286

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: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ccdawn/codex-skills

AGENTS.md AGENTS.md file
ccdawn/codex-skills · AGENTS.md
git:20260813.dec1d14 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
ccdawn/codex-skills · CLAUDE.md
git:20260813.dec1d14 · audit A · 6 stars
briefbound-pengyou SKILL.md skill
ccdawn/codex-skills · skills/companion/briefbound-pengyou/SKILL.md · Use when 用户开启闲聊会话——点名「陪我聊聊」「随便聊聊」「聊两句」「朋友模式」,或明确想没目的地东聊西聊。AI 像朋友一样主动找话题、带节奏、说不同意见,而不是顺着用户聊。工作、编码、任务型请求不加载本技能;用户情绪低落想倾诉时转…
git:20261021.9e6ce32 · audit A · 6 stars
briefbound-score-loop SKILL.md skill
ccdawn/codex-skills · skills/competition/briefbound-score-loop/SKILL.md · Use when repeated work is governed by an explicit metric, active baseline, candidate search, promotion rule…
git:20260929.25d03f6 · audit A · 6 stars
briefbound-creative-toolbox SKILL.md skill
ccdawn/codex-skills · skills/creative/briefbound-creative-toolbox/SKILL.md · Use when the user wants non-obvious but useful ideas, concept invention, naming, reframing, variation, selection…
git:20260916.292b0ac · audit A · 6 stars
briefbound-diagram-design SKILL.md skill
ccdawn/codex-skills · skills/creative/briefbound-diagram-design/SKILL.md · Use when creating or redrawing structured diagrams such as architecture, flowcharts, sequences, ER/UML, timelines or…
git:20260916.ed1d50d · audit A · 6 stars
briefbound-adr SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-adr/SKILL.md · Use when the user asks to record a settled architecture or technology decision as an ADR(写 ADR、记录决策、技术选型定案存档), or a…
git:20260929.20085bb · audit A · 6 stars
briefbound-autonomous-collaboration-loop SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-autonomous-collaboration-loop/SKILL.md · Use when the user explicitly enables an automated same-project multi-thread development loop that keeps peer Codex…
git:20260929.25d03f6 · audit A · 6 stars
briefbound-bdd-tdd-development SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-bdd-tdd-development/SKILL.md · Use when an already-defined new behavior or high-risk implementation contract needs a failing test before…
git:20260916.292b0ac · audit A · 6 stars
briefbound-bug-review SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-bug-review/SKILL.md · Use when an observed bug, correctness regression, failing test, build failure, abnormal behavior, or unresolved root…
git:20260916.292b0ac · audit A · 6 stars
briefbound-code-structure-guard SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-code-structure-guard/SKILL.md · Use when active development or explicit refactoring has concrete code-structure risk: a source file is accumulating…
git:20260916.292b0ac · audit A · 6 stars
briefbound-design-system SKILL.md skill
ccdawn/codex-skills · skills/engineering/briefbound-design-system/SKILL.md · Use when a frontend task primarily concerns cross-component design tokens, semantic theming, component APIs, variants…
git:20260929.25d03f6 · audit A · 6 stars

Every file in ccdawn/codex-skills

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