Skip to content

DevNullLtd/Yuzu / .codex/skills/yuzu-plugin-abi

yuzu-plugin-abi

Unverified

Guard Yuzu's stable C plugin ABI, descriptor contract, and loader compatibility. Use when changing `sdk/include/yuzu/plugin.h`, `plugin.hpp`, plugin descriptors, `agents/core/src/plugin_loader.cpp`, built-in plugins, or plugin action surfaces that affect compatibility.

Yuzu Plugin ABI

Treat The Boundary As Hard

  • Treat sdk/include/yuzu/plugin.h as the stable C ABI.
  • Do not reorder or remove struct fields.
  • Append new struct fields only at the end.
  • Do not let C++ types, exceptions, or STL containers cross the C boundary.
  • Bump YUZU_PLUGIN_ABI_VERSION when the binary contract changes.

Keep The Runtime Contract Aligned

  • Keep plugin.hpp convenience wrappers aligned with plugin.h.
  • Keep agents/core/src/plugin_loader.cpp compatibility checks aligned with the declared ABI range.
  • Preserve yuzu_plugin_descriptor() expectations and exported symbol names.

Watch Action Surface Changes

  • If a plugin adds, removes, or renames actions, inspect corresponding instruction definitions under content/definitions/.
  • Keep descriptor strings, action arrays, and tests consistent.
  • Recheck plugin loader diagnostics if the descriptor layout or SDK version fields change.

Validate

  • Build the agent targets.
  • Run descriptor and loader coverage first, especially tests/unit/test_new_plugins.cpp and tests/unit/test_plugin_loader.cpp.
  • Run the narrowest relevant agent suite before expanding outward.

Invoke Sibling Skills

  • Invoke $yuzu-meson for build-graph changes.
  • Invoke $yuzu-windows-msvc if the change affects Windows export or loading behavior.
  • Invoke $yuzu-build for compile and test flow.

Read On Demand

  • sdk/include/yuzu/plugin.h
  • sdk/include/yuzu/plugin.hpp
  • agents/core/src/plugin_loader.cpp
  • tests/unit/test_new_plugins.cpp
  • tests/unit/test_plugin_loader.cpp
  • content/definitions/
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall