Initial commit

.trellis/spec/frontend/hook-guidelines.md

@@ -0,0 +1,31 @@
+# Hook Guidelines
+
+> Hook conventions for this frontend.
+
+---
+
+## Decision
+
+There are no React, Vue, or hook-based frontend conventions in this project.
+The established frontend approach is JSP/CSS rendered by Servlets on Tomcat.
+
+Do not introduce React hooks, Vue composables, SPA lifecycle hooks, client-side
+state hooks, or hook-style data fetching unless the developer explicitly changes
+the stack later.
+
+---
+
+## JSP Alternative
+
+For reusable presentation behavior, use JSP includes/fragments, tag files if
+introduced, request attributes, session attributes for authenticated identity,
+and small page scripts only when server-rendered JSP cannot handle the
+interaction cleanly.
+
+---
+
+## Future Updates
+
+If a JavaScript framework is explicitly introduced later, replace this file
+with concrete conventions from the new source code and update the frontend
+index status at the same time.