- This is a Node.js 18+ ESM Codex plugin. Keep behavior portable across macOS, Linux, and native Windows.
- Fix shared behavior at the earliest common boundary, usually in
scripts/lib/; do not add caller-specific workarounds. - When changing a skill or runtime contract, keep
skills/,internal-skills/,scripts/, and the matching tests in sync. - Run
npm run checkbefore merging. - For releases, update
CHANGELOG.mdand keeppackage.jsonand.codex-plugin/plugin.jsonversions synchronized.