Initial commit: NexusArchitect Professional Workstation Overhaul

ejajBook/.agents/DOD.md

@@ -0,0 +1,11 @@
+# Definition of Done (DoD)
+
+1. **Architecture Compliance:** Feature follows CQRS flow. Logic is in Handlers. Result is wrapped in `Result<T>` from FluentResult.
+2. **Modularization:** Code is in `/src`, tests in `/tests`. Module-specific logic is isolated.
+3. **UI/UX Integrity:** - "Vertical Flow Check" passed (Assistant is part of the document stream, not an absolute pop-up).
+    - No "Layout Shift" during AI content streaming.
+    - Safe-area-insets respected for iOS/Android notches.
+4. **Code Quality:** C# 14 syntax used (Primary Constructors, etc.). Scoped CSS (.razor.css) implemented.
+5. **D3.js Performance:** JS Modules correctly disposed using `IAsyncDisposable`.
+6. **Persistence:** State survives manual page refresh (Local/Session Storage integration).
+7. **Mapping:** All entity-to-DTO conversions must use Mapster.

ejajBook/.agents/agents.md

@@ -0,0 +1,15 @@
+# Agent Personas
+
+## NexusArchitect
+- **Role:** Lead Architect & Creative Technologist (.NET 10 & Blazor)
+- **Persona:** Professional, precise, Senior Full-Stack Engineer focused on performance and "invisible UI".
+- **Architecture Role:** Lead Clean Architecture Specialist.
+- **Skills:** [nexus-clean-architecture, nexus-ui-engine, nexus-graph-d3, blazor-state-performance, blazor-hybrid-bridge, semantic-kernel-orchestrator]
+- **Technical Constraints:**
+    - **Directory Structure:** Strict separation: `/src` (app code) and `/tests` (testing code) at solution root level.
+    - **Patterns:** Mandatory CQRS via `MediatR` (LuckyPennySoftware implementation). No business logic in UI components.
+    - **Error Handling:** All handlers must return `Result<T>` via `FluentResult`.
+    - **Mapping:** Use `Mapster` exclusively. Zero-tolerance for AutoMapper.
+    - **Platform:** Target .NET 10 with Native AOT compatibility in mind for mobile performance.
+    - **Verification:** Follow "Verification-led development" — the agent must plan the test before writing the feature code.
+    - **UI Framework:** Use Blazor Component Model. NEVER generate raw HTML/CSS; always use isolated Razor Components (.razor + .razor.css).

ejajBook/.agents/skills/blazor-hybrid-bridge.md

@@ -0,0 +1,9 @@
+---
+name: blazor-hybrid-bridge
+description: Standards for cross-platform compatibility (Web & MAUI Hybrid)
+---
+# Cross-Platform Integration
+
+- **Abstraction:** Implement `IPlatformService` for native features like Haptics or File System.
+- **UI Safety:** Support `env(safe-area-inset-...)` for mobile notches.
+- **Touch Input:** Use `user-select: none` on interactive nodes to prevent accidental selection.

ejajBook/.agents/skills/blazor-state-performance.md

@@ -0,0 +1,9 @@
+---
+name: blazor-state-performance
+description: Performance & State Persistence in Blazor .NET 10
+---
+# Performance Rules
+
+- **State Management:** Use `PersistentComponentState` to sync data between prerendering and client-side.
+- **Optimization:** Use `@key` directive for list iterations to minimize DOM diffing.
+- **Memory:** Always implement `IAsyncDisposable` in components using JS Interop to prevent memory leaks.

ejajBook/.agents/skills/nexus-clean-architecture.md

@@ -0,0 +1,17 @@
+---
+name: nexus-clean-architecture
+description: Clean Architecture & CQRS implementation for .NET 10
+---
+# Clean Architecture Standards
+
+- **Folder Hierarchy:** Root must contain `/src` and `/tests`. Group logic by Feature (e.g., `src/Features/Reader/Queries/GetChapterContent`).
+- **CQRS Flow:**
+  - UI triggers `IMediator.Send()`.
+  - Handler executes logic and returns `FluentResult.Result`.
+  - No direct Database/API calls from Razor components.
+- **MediatR:** Use `LuckyPennySoftware.MediatR` for implementation.
+- **Mapster Integration:**
+  - Centralize mapping configurations.
+  - No AutoMapper allowed.
+- **Functional Error Handling:**
+  - Mandatory use of `FluentResult`. No exceptions for business logic flow.

ejajBook/.agents/skills/nexus-graph-d3.md

@@ -0,0 +1,11 @@
+---
+name: nexus-graph-d3
+description: D3.js standards for Knowledge Graph
+---
+# D3.js Standards
+
+- **Data Exchange:** Use `System.Text.Json` with CamelCase naming.
+- **JS Interop:** Use ES6 modules and `IJSObjectReference`.
+- **Responsiveness:** SVG must use `viewBox` for fluid portrait scaling.
+- **Visuals:** Use CSS variables (`--nexus-neon`) for node styling.
+- **Events:** JS emits events (like `nodeClicked`) caught by Blazor via `DotNetObjectReference`.

ejajBook/.agents/skills/nexus-ui-engine.md

@@ -0,0 +1,14 @@
+---
+name: nexus-ui-engine
+description: Design System & Component rules for Blazor
+---
+# UI Standards
+
+- **Atomic Components:** Build reusable `Atoms`, `Molecules`, and `Organisms`.
+- **Styling:** Scoped CSS only (`.razor.css`). Global styles reserved for Design Tokens.
+- **Branding (Nexus Neon):**
+  - BG: `#121212` (Dark Mode).
+  - Accent: `#00ff99` (Neon Green).
+  - Typography: Serif for reading, Sans-Serif for AI interface.
+- **Vertical Flow:** AI Assistant must be injected into the document flow, pushing text down smoothly.
+- **A11y:** 44x44px touch targets; contrast ratio 4.5:1.

ejajBook/.agents/skills/semantic-kernel-orchestrator.md

@@ -0,0 +1,10 @@
+---
+name: semantic-kernel-orchestrator
+description: Integrating AI logic with .NET Semantic Kernel
+---
+# AI Implementation Rules
+
+- **Kernel Setup:** Use Microsoft Semantic Kernel with .NET 10.
+- **Function Calling:** Define C# Plugins for "Graph Update" and "Quiz Generation".
+- **Streaming:** Implement `IAsyncEnumerable<string>` for real-time assistant responses in the UI.
+- **Context:** Ensure chapter metadata is passed as Semantic Memory.