🚀 engineer-sdk v1.0.0

First stable public release of engineer-sdk — a portable, vendor-neutral agent skill for professional SDK engineering: assess, design, create, modernize, migrate, simplify, validate, document, and release SDKs across any language, framework, runtime, source shape, or delivery model.

Release status: v1.0.0 — battle-tested through real engagements spanning browser-script modernization and greenfield native/framework SDK creation before publication.

✨ Highlights

• 🧭 Discovery before architecture — product, consumer, contract, ownership, and delivery evidence gathered read-only before any design decision.
• 🤝 Consumer-first — the install/start/use happy path is written before internal structure; complexity is measured from the consumer's side.
• 🧊 Contract preservation — public and implicit contracts (wire encodings, timing, identities, state) are frozen, classified, and characterized before refactoring; breaking changes require explicit approved migrations.
• 🚦 Phased workflow with approval gates — nine phases, four-point gate reports, and a hard split between phase approval and operational permission.
• ⚖️ Proportionality both ways — shortfalls against the engineering standard need owner approval, and additions beyond it need evidence.
• 🐍 Bundled validation scripts — seven parameterized Python 3 stdlib tools (inventory, boundaries, artifacts, generated freshness, metadata, docs, isolated consumer checks), safe by default and covered by a 28-test suite.
• 🗺️ Conditional platform profiles — browser script, server client library, framework wrapper, native/mobile, generated client, CLI, and ecosystem-embedded plugins, loaded only when the runtime is confirmed.

🛡️ Battle-tested

Every rule in this release was earned, not theorized: a browser-script SDK modernization run end-to-end, a greenfield native/framework SDK creation, and post-release hardening feedback — with each field-found failure mode folded back into the skill as a stack-neutral rule before v1.0.0 was cut.

📦 Install

git clone https://github.com/Veritas-Quaesitor/vq-sdk-engineering-skill.git
cp -r vq-sdk-engineering-skill/skill/engineer-sdk ~/.claude/skills/engineer-sdk

The installable skill is the skill/engineer-sdk/ folder; see the README for per-project installs and other agent hosts. The bundled scripts need only Python 3 — no dependencies.

📄 License

This project is licensed under the MIT License.