Where the framework ends and the robot begins

Skill Registry & the L4 Embodiment Boundary

ANIMA touches concrete robots through the skill registry (L3) and the EmbodiedAdapter protocol (L4), without swallowing hardware-specific details into the framework. This boundary determines whether ANIMA can move to the next robot or stays trapped inside a single demo.

Shared logic (framework)

L0–L3 + L5: signal gateway, parsing, planning, skill selection, self-assessment. None of this depends on a specific robot.

Embodied logic (L4 adapter)

Joint parameters, motion constraints, gripper physics, base dynamics. Each robot gets its own L4 implementation; the framework itself stays untouched.

Protocols: LLMToolCaller + EmbodiedAdapter

Two Protocols live in the anima repo. LLMToolCaller makes DeepSeek / OpenAI / Claude pluggable; EmbodiedAdapter makes manipulator / mobile base / wheelchair / humanoid pluggable.

Why it matters

soma-arm (real-hardware tabletop) and soma-care (simulated ward) each ship their own L4. The same L1–L3 drives both — that's what this boundary buys when it's drawn in the right place.

Key points

Why this layer matters

  • The framework must stay reusable, so it cannot swallow hardware details
  • The robot must face real physics, so it cannot be abstracted away by the framework
  • The L4 protocol is the thin boundary that keeps these two concerns separate
Related robots

Current robot carriers