The first thing I would do is stop trying to support AI tools, and remove any comments about AI from the documentation.
Generative AI is not suitable for building content-driven websites because it lacks context to understand subjective user preferences.
Also, having .astro files to implement island functionality is unnecessary. Interactivity can be implemented with Javascript using web components.
