Home / ccdawn / codex-skills · skills/engineering/briefbound-api-contract/SKILL.md · GitHub

briefbound-api-contract skillA

briefbound-api-contract is agent-read markdown (skill) from ccdawn/codex-skills: 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..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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

Latest version
mdr add ccdawn/codex-skills/briefbound-api-contract@git:20260920.280b6d2
Exact content
mdr add ccdawn/codex-skills/briefbound-api-contract@sha256:9703c8f97d22c8a3

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

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

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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-09-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 agent 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.

More from ccdawn/codex-skills

AGENTS.md agents
ccdawn/codex-skills · AGENTS.md
git:20260813.dec1d14 · audit A · 6 stars
CLAUDE.md claude
ccdawn/codex-skills · CLAUDE.md
git:20260813.dec1d14 · audit A · 6 stars
briefbound-huawei-nslb-score-loop skill
ccdawn/codex-skills · skills/competition/briefbound-huawei-nslb-score-loop/SKILL.md · Use when a Huawei Algorithm Challenge 37 NSLB workspace needs live status, adaptive solver search, comparable…
git:20260916.292b0ac · audit A · 6 stars
briefbound-score-loop 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:20260916.292b0ac · audit A · 6 stars
briefbound-creative-toolbox 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
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-autonomous-collaboration-loop 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:20260919.ae05288 · audit A · 6 stars
briefbound-bdd-tdd-development 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
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
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
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:20260916.292b0ac · audit A · 6 stars
briefbound-development-cleanup skill
ccdawn/codex-skills · skills/engineering/briefbound-development-cleanup/SKILL.md · Use when a verified or integrated software change has concrete temporary artifacts, generated noise, task-owned…
git:20260919.ae05288 · audit A · 6 stars

Every file in ccdawn/codex-skills

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