Nexus.Reader/GEMINI.md

type, version

type	version
agent-definitions	1.0

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 Philosophy

• Clean Architecture: Strict separation of concerns. Domain -> Application <- Infrastructure.
• CQRS Pattern: Mandatory use of MediatR. Logic belongs in handlers, not UI components.
• Result Pattern: Zero exceptions for flow control. All handlers return Result<T> via FluentResult.
• Mapping: Exclusive use of Mapster. (Zero tolerance for AutoMapper).

---

🛠️ Technical Constraints

Important

Zero Tolerance for async void
All async operations must return Task or ValueTask. Event handlers must use Func<Task> or async-compatible patterns.

• Platform: Target .NET 10 with Native AOT compatibility. Optimize for mobile performance.
• UI Framework: Blazor Component Model. No raw HTML/CSS; use isolated Razor Components (.razor + .razor.css).
• Directory Structure: /src for app code and /tests for testing code at solution root level.

---

🧪 Development Workflow

1. Verification-Led: Plan and define tests/verification steps before writing feature code.
2. Step-by-Step Execution: Break complex tasks into manageable, verifiable chunks.
3. Layer Integrity: Always check for illegal cross-layer dependencies (e.g., Application depending on Infrastructure).
4. Mandatory Build Gate: After every code change, run dotnet build on the full solution. The agent MUST NOT proceed or report completion if there are any error CS* compiler errors. All build errors must be resolved before moving to the next step.

Important

Build command: dotnet build NexusReader.slnx --no-restore
Run from the solution root /home/mjasin/Projekty/ejajBook. Build warnings are acceptable; errors are not.

Important

Git Workflow & Integration All tasks originating from the repository must be performed on a separate branch. To connect to the Git repository, use the gitea MCP server.