Hwc Stimulus Fundamentals

What it does

This skill provides foundational knowledge of HWC Stimulus concepts, enabling AI agents to help developers implement robust Stimulus controllers. It focuses on understanding controller lifecycles, state management, and best practices for building composable and maintainable code. The skill guides users through core workflows like defining controller contracts and using outlets for inter-controller communication.

When to use it

• When you need guidance on structuring a new Stimulus controller.
• To understand how to manage state transitions within a Stimulus application.
• For help with isolating DOM event handling from business logic in your controllers.
• When troubleshooting issues related to controller lifecycle events (connect/disconnect).
• To learn best practices for inter-controller communication using the Outlets API.

Key capabilities

• Defines a core workflow for Stimulus controller development, including contract definition and state management.
• Provides guardrails for writing maintainable and composable controllers.
• Offers references to specific documentation on topics like value changed callbacks, keyboard action filters, MutationObserver usage, and the Outlets API.
• Suggests escalation paths to other HWC skills for related concerns (forms validation, navigation, real-time streaming, media integration, UX feedback).

Example prompts

• "Explain how to define a controller contract in Stimulus."
• "What is the best way to handle state transitions within a Stimulus controller?"
• "How do I use outlets for communication between Stimulus controllers?"
• "Show me an example of using MutationObserver in a Stimulus controller."

Tips & gotchas

• This skill provides foundational knowledge; it's not a complete implementation guide.
• Refer to the references/INDEX.md file for a full catalog of available documentation.
• Consider escalating to other HWC skills (like hwc-forms-validation) when dealing with related concerns.