Skip to main content
AI/MLjmagly

deprecation-policy

Compare API/ABI surfaces between refs, flag incompatible changes, and generate deprecation/changelog notes for library projects

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--deprecation-policy
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/frameworks/security-engineering/skills/deprecation-policy/SKILL.md -o .claude/skills/deprecation-policy.md

Drops the SKILL.md into .claude/skills/deprecation-policy.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Deprecation Policy

Compare public API/ABI surfaces and enforce the api-abi-stability rule for library and SDK projects. This maps curl Practice 26 into AIWG release governance.

Language Strategies

  • C/C++: compare exported headers, function prototypes, struct layout, and symbol lists.
  • Rust: integrate cargo public-api where available; report removed exported items.
  • Go: run apidiff from golang.org/x/exp/cmd/apidiff.
  • TypeScript: use api-extractor or declaration-file diffs.

Output

The report classifies changes as additive, compatible, deprecated, removal, ABI-breaking, or experimental. It also drafts changelog text for each deprecation or removal.

Composition

Use with flow-change-control for request-level approval. This skill owns the API/ABI technical check and release-note evidence.

References

  • agentic/code/frameworks/security-engineering/rules/api-abi-stability.md
  • SemVer
  • curl ABI policy