Behavior Tree Decorator Nodes

Source: ros2-copilot-skills BT decorator nodes skill

Why This Matters

Decorator nodes are small but influential. They change how often a subtree runs, when it is allowed to run, or how its result is interpreted, which means they can silently control much of the tree's real behavior.

Distilled Takeaways

• Decorators modify child-node behavior without changing the subtree body itself.
• They are useful for retries, timing, gating, inversion, and rate control.
• Overusing decorators can make a tree harder to reason about than necessary.
• They are often the hidden cause of surprising repeat or skip behavior.

Practical Guidance

• Use decorators when they make the tree simpler, not merely more clever.
• Check decorator semantics first when a subtree runs too often or not often enough.
• Keep rate and retry behavior explicit.
• Document non-obvious decorators in complex trees.

Corroborating References

• BehaviorTree.CPP documentation
• Nav2 behavior tree docs

When to Read the Original Source

Go to the original skill when you want the decorator-specific examples and the practical reminders about rate, retry, and gating behavior.