From eac0e9057e0eb3ea14ff713e2a619763a3140d40 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Jasi=C5=84ski?= Date: Sun, 3 May 2026 16:17:43 +0200 Subject: [PATCH] refactor: migrate agent configurations and skills to the .agent directory and add project documentation --- .../skills/blazor-hybrid-bridge/SKILL.md | 0 .../skills/blazor-state-performance/SKILL.md | 0 .../skills/dotnet-async-void/SKILL.md | 0 .../skills/nexus-clean-architecture/SKILL.md | 0 .../skills/nexus-code-review/SKILL.md | 0 .../skills/nexus-graph-d3/SKILL.md | 0 .../skills/nexus-identity-saas/SKILL.md | 0 .../skills/nexus-ui-engine/SKILL.md | 0 .../semantic-kernel-orchestrator/SKILL.md | 0 .agents/DOD.md | 11 ------ .agents/agents.md | 22 ----------- GEMINI.md | 37 +++++++++++++++++++ 12 files changed, 37 insertions(+), 33 deletions(-) rename .agents/skills/blazor-hybrid-bridge.md => .agent/skills/blazor-hybrid-bridge/SKILL.md (100%) rename .agents/skills/blazor-state-performance.md => .agent/skills/blazor-state-performance/SKILL.md (100%) rename .agents/skills/dotnet-async-void.md => .agent/skills/dotnet-async-void/SKILL.md (100%) rename .agents/skills/nexus-clean-architecture.md => .agent/skills/nexus-clean-architecture/SKILL.md (100%) rename .agents/skills/nexus-code-review.md => .agent/skills/nexus-code-review/SKILL.md (100%) rename .agents/skills/nexus-graph-d3.md => .agent/skills/nexus-graph-d3/SKILL.md (100%) rename .agents/skills/nexus-identity-saas.md => .agent/skills/nexus-identity-saas/SKILL.md (100%) rename .agents/skills/nexus-ui-engine.md => .agent/skills/nexus-ui-engine/SKILL.md (100%) rename .agents/skills/semantic-kernel-orchestrator.md => .agent/skills/semantic-kernel-orchestrator/SKILL.md (100%) delete mode 100644 .agents/DOD.md delete mode 100644 .agents/agents.md create mode 100644 GEMINI.md diff --git a/.agents/skills/blazor-hybrid-bridge.md b/.agent/skills/blazor-hybrid-bridge/SKILL.md similarity index 100% rename from .agents/skills/blazor-hybrid-bridge.md rename to .agent/skills/blazor-hybrid-bridge/SKILL.md diff --git a/.agents/skills/blazor-state-performance.md b/.agent/skills/blazor-state-performance/SKILL.md similarity index 100% rename from .agents/skills/blazor-state-performance.md rename to .agent/skills/blazor-state-performance/SKILL.md diff --git a/.agents/skills/dotnet-async-void.md b/.agent/skills/dotnet-async-void/SKILL.md similarity index 100% rename from .agents/skills/dotnet-async-void.md rename to .agent/skills/dotnet-async-void/SKILL.md diff --git a/.agents/skills/nexus-clean-architecture.md b/.agent/skills/nexus-clean-architecture/SKILL.md similarity index 100% rename from .agents/skills/nexus-clean-architecture.md rename to .agent/skills/nexus-clean-architecture/SKILL.md diff --git a/.agents/skills/nexus-code-review.md b/.agent/skills/nexus-code-review/SKILL.md similarity index 100% rename from .agents/skills/nexus-code-review.md rename to .agent/skills/nexus-code-review/SKILL.md diff --git a/.agents/skills/nexus-graph-d3.md b/.agent/skills/nexus-graph-d3/SKILL.md similarity index 100% rename from .agents/skills/nexus-graph-d3.md rename to .agent/skills/nexus-graph-d3/SKILL.md diff --git a/.agents/skills/nexus-identity-saas.md b/.agent/skills/nexus-identity-saas/SKILL.md similarity index 100% rename from .agents/skills/nexus-identity-saas.md rename to .agent/skills/nexus-identity-saas/SKILL.md diff --git a/.agents/skills/nexus-ui-engine.md b/.agent/skills/nexus-ui-engine/SKILL.md similarity index 100% rename from .agents/skills/nexus-ui-engine.md rename to .agent/skills/nexus-ui-engine/SKILL.md diff --git a/.agents/skills/semantic-kernel-orchestrator.md b/.agent/skills/semantic-kernel-orchestrator/SKILL.md similarity index 100% rename from .agents/skills/semantic-kernel-orchestrator.md rename to .agent/skills/semantic-kernel-orchestrator/SKILL.md diff --git a/.agents/DOD.md b/.agents/DOD.md deleted file mode 100644 index 56058c0..0000000 --- a/.agents/DOD.md +++ /dev/null @@ -1,11 +0,0 @@ -# Definition of Done (DoD) - -1. **Architecture Compliance:** Feature follows CQRS flow. Logic is in Handlers. Result is wrapped in `Result` 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. \ No newline at end of file diff --git a/.agents/agents.md b/.agents/agents.md deleted file mode 100644 index 34cf70f..0000000 --- a/.agents/agents.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -type: agent-definitions -version: 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 Role:** Lead Clean Architecture Specialist. -- **Skills:** [nexus-clean-architecture, nexus-ui-engine, nexus-graph-d3, blazor-state-performance, blazor-hybrid-bridge, semantic-kernel-orchestrator, nexus-identity-saas, dotnet-async-void] -- **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. - - **Async:** Strict zero-tolerance for `async void`. All async operations must return `Task` or `ValueTask`. Event handlers must use `Func` or async-compatible patterns. - - **Error Handling:** All handlers must return `Result` 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). diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..48faa63 --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,37 @@ +--- +type: agent-definitions +version: 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` 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` 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). +