docs: add comprehensive AGENTS.md documentation for project rules and guidelines

Author: Claude Code Plugin Developer

.roo/rules-architect/AGENTS.md

@@ -0,0 +1,8 @@
+# Project Architecture Rules (Non-Obvious Only)
+
+- Hugo module uses Go 1.19+ with extended version requirement (not standard Hugo setup)
+- Module vendoring mandatory before builds (Go mod indirect dependencies)
+- Example site serves as both demo and build target (dual-purpose architecture)
+- Resources directory cleaned with public (non-standard Hugo resource management)
+- Module structure uses Hugo mounts for all assets (not traditional Hugo directories)
+- Hinode framework modules integrated through Go mod (framework-specific architecture)

.roo/rules-ask/AGENTS.md

@@ -0,0 +1,7 @@
+# Project Documentation Rules (Non-Obvious Only)
+
+- Example site serves dual purpose as both demo and build target (not separate documentation site)
+- Module structure uses Hugo mounts for assets, layouts, i18n, data (counterintuitive directory organization)
+- Test command builds only, not runs tests (misleading npm script naming)
+- Resources directory cleaned alongside public (non-standard Hugo documentation workflow)
+- Playwright tests are E2E only, no unit tests (limited testing documentation)

.roo/rules-code/AGENTS.md

@@ -0,0 +1,8 @@
+# Project Coding Rules (Non-Obvious Only)
+
+- Hugo module vendoring required before any build operations (npm run mod:vendor)
+- Module structure uses Hugo mounts for assets, layouts, i18n, data (not standard Hugo directory structure)
+- Example site serves dual purpose as both demo and build target
+- Resources directory cleaned alongside public directory (non-standard Hugo behavior)
+- Playwright tests auto-install browsers on postinstall (requires network access)
+- Module dependencies managed through Go mod with indirect Hinode framework modules

.roo/rules-debug/AGENTS.md

@@ -0,0 +1,7 @@
+# Project Debug Rules (Non-Obvious Only)
+
+- Playwright tests require Hugo server running (auto-started by config, not manual)
+- Test command (npm run test) builds only, not runs tests (use npm run test:playwright)
+- Module vendoring failures prevent builds silently (check go.mod dependencies)
+- Example site serves as build target, not separate debug environment
+- Resources directory cleaned with public (non-standard Hugo debug workflow)