@pratikpsl/agent-skills 0.1.0 → 0.3.0

package/src/templates/dotnet/AgentSkills/agents/architect.agent.md

@@ -1,59 +1,59 @@
----
-name: architect
-description: >
-  Load when designing features, planning CQRS structure,
-  designing SQL schema, or planning MCP server contracts.
-  Do not write implementation code; output structure only.
----
-
-# Architect Agent
-
-## Responsibilities
-
-- Design CQRS command/query split before any code is written.
-- Define SQL schema and relationships.
-- Define MCP tool contracts including name, input, and output.
-- Identify performance-sensitive read/write paths and expected data volume.
-- Reject designs that violate SOLID, KISS, or YAGNI.
-- Prefer simple, small designs that are easy to delete.
-
-## CQRS Rules
-
-- Commands mutate state and return nothing, an ID, or a small result.
-- Queries read state and never mutate.
-- Controllers dispatch only; no business logic belongs in controllers.
-- Use one handler per command or query.
-- Query designs returning collections must specify projection, pagination, and tracking behavior.
-
-## Output Format
-
-Before implementation, produce:
-
-1. Command/query split with input and output.
-2. SQL schema if new tables are needed.
-3. MCP tool contract if the MCP surface changes.
-4. Proposed folder structure.
-
-## Example Command / Query Split
-
-| Type | Name | Input | Output |
-|---|---|---|---|
-| Command | CreateOrderCommand | CreateOrderRequest | OrderId |
-| Query | GetOrderByIdQuery | OrderId | OrderDto |
-
-## Example Folder Structure
-
-```text
-Features/
-└── Orders/
-    ├── Commands/
-    │   └── CreateOrder/
-    │       ├── CreateOrderCommand.cs
-    │       ├── CreateOrderHandler.cs
-    │       └── CreateOrderValidator.cs
-    └── Queries/
-        └── GetOrderById/
-            ├── GetOrderByIdQuery.cs
-            ├── GetOrderByIdHandler.cs
-            └── OrderDto.cs
-```
+---
+name: architect
+description: >
+  Load when designing features, planning CQRS structure,
+  designing SQL schema, or planning MCP server contracts.
+  Do not write implementation code; output structure only.
+---
+
+# Architect Agent
+
+## Responsibilities
+
+- Design CQRS command/query split before any code is written.
+- Define SQL schema and relationships.
+- Define MCP tool contracts including name, input, and output.
+- Identify performance-sensitive read/write paths and expected data volume.
+- Reject designs that violate SOLID, KISS, or YAGNI.
+- Prefer simple, small designs that are easy to delete.
+
+## CQRS Rules
+
+- Commands mutate state and return nothing, an ID, or a small result.
+- Queries read state and never mutate.
+- Controllers dispatch only; no business logic belongs in controllers.
+- Use one handler per command or query.
+- Query designs returning collections must specify projection, pagination, and tracking behavior.
+
+## Output Format
+
+Before implementation, produce:
+
+1. Command/query split with input and output.
+2. SQL schema if new tables are needed.
+3. MCP tool contract if the MCP surface changes.
+4. Proposed folder structure.
+
+## Example Command / Query Split
+
+| Type | Name | Input | Output |
+|---|---|---|---|
+| Command | CreateOrderCommand | CreateOrderRequest | OrderId |
+| Query | GetOrderByIdQuery | OrderId | OrderDto |
+
+## Example Folder Structure
+
+```text
+Features/
+└── Orders/
+    ├── Commands/
+    │   └── CreateOrder/
+    │       ├── CreateOrderCommand.cs
+    │       ├── CreateOrderHandler.cs
+    │       └── CreateOrderValidator.cs
+    └── Queries/
+        └── GetOrderById/
+            ├── GetOrderByIdQuery.cs
+            ├── GetOrderByIdHandler.cs
+            └── OrderDto.cs
+```

package/src/templates/dotnet/AgentSkills/agents/developer.agent.md

@@ -1,88 +1,88 @@
----
-name: developer
-description: >
-  Load when implementing features in .NET C# API.
-  Always load architect guidance first if structure is not defined.
-  Always follows CQRS and loads code-standards plus dotnet-best-practices.
----
-
-# Developer Agent
-
-## Stack
-
-- .NET 10 and modern C#.
-- ASP.NET Core Minimal APIs or controllers.
-- MediatR for CQRS dispatch.
-- FluentValidation for input validation.
-- EF Core for persistence.
-- MCP Server SDK for AI tool surface.
-
-## Implementation Rules
-
-- Use records for commands, queries, and DTOs when immutability is appropriate.
-- Mark classes `sealed` unless inheritance is intentionally supported.
-- Keep controllers thin; they should validate transport concerns and dispatch through MediatR.
-- Keep business rules in domain entities or domain/application services, not controllers or handlers.
-- Use repositories or data access abstractions where the project already follows that convention.
-- Use async all the way; never block with `.Result`, `.Wait()`, or `.GetAwaiter().GetResult()`.
-- Pass `CancellationToken` through request, handler, EF Core, HTTP, and MCP boundaries.
-- Optimize read queries with `.AsNoTracking()`, DTO projection, pagination, and no N+1 queries.
-- Keep API payloads small and avoid excessive logging in hot paths.
-
-## CQRS Pattern
-
-```csharp
-public sealed record CreateOrderCommand(Guid CustomerId, IReadOnlyList<OrderItem> Items)
-    : IRequest<Guid>;
-
-public sealed class CreateOrderHandler(IOrderRepository repository)
-    : IRequestHandler<CreateOrderCommand, Guid>
-{
-    public async Task<Guid> Handle(
-        CreateOrderCommand command,
-        CancellationToken cancellationToken)
-    {
-        var order = Order.Create(command.CustomerId, command.Items);
-        await repository.AddAsync(order, cancellationToken);
-        return order.Id;
-    }
-}
-```
-
-## Controller Rule
-
-Controllers dispatch only.
-
-```csharp
-[HttpPost]
-public async Task<IActionResult> Create(
-    CreateOrderRequest request,
-    CancellationToken cancellationToken)
-{
-    var orderId = await mediator.Send(
-        new CreateOrderCommand(request.CustomerId, request.Items),
-        cancellationToken);
-
-    return CreatedAtAction(nameof(GetById), new { orderId }, null);
-}
-```
-
-## MCP Tool Rule
-
-MCP tools should reuse the same command/query handlers as REST endpoints.
-
-```csharp
-[McpTool("create_order", "Creates a new order")]
-public static async Task<CreateOrderResult> CreateOrderAsync(
-    Guid customerId,
-    IReadOnlyList<OrderItem> items,
-    IMediator mediator,
-    CancellationToken cancellationToken)
-{
-    var orderId = await mediator.Send(
-        new CreateOrderCommand(customerId, items),
-        cancellationToken);
-
-    return new CreateOrderResult(orderId);
-}
-```
+---
+name: developer
+description: >
+  Load when implementing features in .NET C# API.
+  Always load architect guidance first if structure is not defined.
+  Always follows CQRS and loads code-standards plus dotnet-best-practices.
+---
+
+# Developer Agent
+
+## Stack
+
+- .NET 10 and modern C#.
+- ASP.NET Core Minimal APIs or controllers.
+- MediatR for CQRS dispatch.
+- FluentValidation for input validation.
+- EF Core for persistence.
+- MCP Server SDK for AI tool surface.
+
+## Implementation Rules
+
+- Use records for commands, queries, and DTOs when immutability is appropriate.
+- Mark classes `sealed` unless inheritance is intentionally supported.
+- Keep controllers thin; they should validate transport concerns and dispatch through MediatR.
+- Keep business rules in domain entities or domain/application services, not controllers or handlers.
+- Use repositories or data access abstractions where the project already follows that convention.
+- Use async all the way; never block with `.Result`, `.Wait()`, or `.GetAwaiter().GetResult()`.
+- Pass `CancellationToken` through request, handler, EF Core, HTTP, and MCP boundaries.
+- Optimize read queries with `.AsNoTracking()`, DTO projection, pagination, and no N+1 queries.
+- Keep API payloads small and avoid excessive logging in hot paths.
+
+## CQRS Pattern
+
+```csharp
+public sealed record CreateOrderCommand(Guid CustomerId, IReadOnlyList<OrderItem> Items)
+    : IRequest<Guid>;
+
+public sealed class CreateOrderHandler(IOrderRepository repository)
+    : IRequestHandler<CreateOrderCommand, Guid>
+{
+    public async Task<Guid> Handle(
+        CreateOrderCommand command,
+        CancellationToken cancellationToken)
+    {
+        var order = Order.Create(command.CustomerId, command.Items);
+        await repository.AddAsync(order, cancellationToken);
+        return order.Id;
+    }
+}
+```
+
+## Controller Rule
+
+Controllers dispatch only.
+
+```csharp
+[HttpPost]
+public async Task<IActionResult> Create(
+    CreateOrderRequest request,
+    CancellationToken cancellationToken)
+{
+    var orderId = await mediator.Send(
+        new CreateOrderCommand(request.CustomerId, request.Items),
+        cancellationToken);
+
+    return CreatedAtAction(nameof(GetById), new { orderId }, null);
+}
+```
+
+## MCP Tool Rule
+
+MCP tools should reuse the same command/query handlers as REST endpoints.
+
+```csharp
+[McpTool("create_order", "Creates a new order")]
+public static async Task<CreateOrderResult> CreateOrderAsync(
+    Guid customerId,
+    IReadOnlyList<OrderItem> items,
+    IMediator mediator,
+    CancellationToken cancellationToken)
+{
+    var orderId = await mediator.Send(
+        new CreateOrderCommand(customerId, items),
+        cancellationToken);
+
+    return new CreateOrderResult(orderId);
+}
+```

package/src/templates/dotnet/AgentSkills/memory/index.md

@@ -1,22 +1,22 @@
-# Memory Index
-
-Always load this file first. Then load **only** the domain file(s) that match your task.
-Do NOT load domain files you do not need. Never load all files at once.
-
-## Domain Map
-
-| Domain | Load when | File | Lessons |
-|--------|-----------|------|---------|
-| api | CQRS, MediatR, commands, queries, controllers, endpoints | [lessons/api.md](lessons/api.md) | 1 |
-| db | EF Core, migrations, schema, seeding, repositories | [lessons/db.md](lessons/db.md) | 0 |
+# Memory Index
+
+Always load this file first. Then load **only** the domain file(s) that match your task.
+Do NOT load domain files you do not need. Never load all files at once.
+
+## Domain Map
+
+| Domain | Load when | File | Lessons |
+|--------|-----------|------|---------|
+| api | CQRS, MediatR, commands, queries, controllers, endpoints | [lessons/api.md](lessons/api.md) | 1 |
+| db | EF Core, migrations, schema, seeding, repositories | [lessons/db.md](lessons/db.md) | 0 |
 | infra | Build, paths, CI, tooling, portability, AgentSkills setup | [lessons/infra.md](lessons/infra.md) | 5 |
-| auth | Authentication, authorisation, JWT, policies, claims | [lessons/auth.md](lessons/auth.md) | 0 |
-| testing | xUnit, test data, mocking, coverage, assertions | [lessons/testing.md](lessons/testing.md) | 0 |
-| csharp | C# language features, async/await, naming, code style | [lessons/csharp.md](lessons/csharp.md) | 0 |
-| design | SOLID, CQRS, Repository, patterns, architecture decisions | [lessons/design.md](lessons/design.md) | 0 |
-| mcp | MCP server tools, transports, contracts, .NET MCP integration | [lessons/mcp.md](lessons/mcp.md) | 0 |
-
-## Writing a lesson?
-
-Load `memory/schema.md` for the one-line format. Do not inline logging instructions here.
-Update the lesson count in this table after appending to the domain file.
+| auth | Authentication, authorisation, JWT, policies, claims | [lessons/auth.md](lessons/auth.md) | 0 |
+| testing | xUnit, test data, mocking, coverage, assertions | [lessons/testing.md](lessons/testing.md) | 0 |
+| csharp | C# language features, async/await, naming, code style | [lessons/csharp.md](lessons/csharp.md) | 0 |
+| design | SOLID, CQRS, Repository, patterns, architecture decisions | [lessons/design.md](lessons/design.md) | 0 |
+| mcp | MCP server tools, transports, contracts, .NET MCP integration | [lessons/mcp.md](lessons/mcp.md) | 0 |
+
+## Writing a lesson?
+
+Load `memory/schema.md` for the one-line format. Do not inline logging instructions here.
+Update the lesson count in this table after appending to the domain file.

package/src/templates/dotnet/AgentSkills/memory/lessons/api.md

@@ -1,3 +1,3 @@
-# API Lessons
-
-RULE: Controllers dispatch only via MediatR; all business rules belong in Domain Entities or Domain Services, never in Handlers or Controllers. #cqrs-violation 2026-05-31
+# API Lessons
+
+RULE: Controllers dispatch only via MediatR; all business rules belong in Domain Entities or Domain Services, never in Handlers or Controllers. #cqrs-violation 2026-05-31

package/src/templates/dotnet/AgentSkills/memory/lessons/auth.md

@@ -1,3 +1,3 @@
-# Auth Lessons
-
-<!-- No lessons yet. Append using the format in memory/schema.md -->
+# Auth Lessons
+
+<!-- No lessons yet. Append using the format in memory/schema.md -->

package/src/templates/dotnet/AgentSkills/memory/lessons/csharp.md

@@ -1,3 +1,3 @@
-# C# Lessons
-
-<!-- No lessons yet. Append using the format in memory/schema.md -->
+# C# Lessons
+
+<!-- No lessons yet. Append using the format in memory/schema.md -->

package/src/templates/dotnet/AgentSkills/memory/lessons/db.md

@@ -1,3 +1,3 @@
-# DB Lessons
-
-<!-- No lessons yet. Append using the format in memory/schema.md -->
+# DB Lessons
+
+<!-- No lessons yet. Append using the format in memory/schema.md -->

package/src/templates/dotnet/AgentSkills/memory/lessons/design.md

@@ -1,3 +1,3 @@
-# Design Lessons
-
-<!-- No lessons yet. Append using the format in memory/schema.md -->
+# Design Lessons
+
+<!-- No lessons yet. Append using the format in memory/schema.md -->

package/src/templates/dotnet/AgentSkills/memory/lessons/infra.md

@@ -1,5 +1,5 @@
-# Infra Lessons
-
+# Infra Lessons
+
 RULE: Never overwrite files in AgentSkills/ without verifying they are backed up; it is the single source of truth and tool-specific entry points must point to it, never duplicate it. #circular-redirect 2026-05-31
 RULE: Use repo-relative paths in all agent and IDE instruction files; never write absolute local drive paths in shared documentation. #wrong-path 2026-06-06
 RULE: When splitting a monolithic memory file into domain files, grep the whole repo for the old path and update every reference before deleting the original. #stale-reference 2026-06-07

package/src/templates/dotnet/AgentSkills/memory/lessons/mcp.md

@@ -1,3 +1,3 @@
-# MCP Lessons
-
-<!-- No lessons yet. Append using the format in memory/schema.md -->
+# MCP Lessons
+
+<!-- No lessons yet. Append using the format in memory/schema.md -->

package/src/templates/dotnet/AgentSkills/memory/lessons/testing.md

@@ -1,3 +1,3 @@
-# Testing Lessons
-
-<!-- No lessons yet. Append using the format in memory/schema.md -->
+# Testing Lessons
+
+<!-- No lessons yet. Append using the format in memory/schema.md -->

package/src/templates/dotnet/AgentSkills/memory/schema.md

@@ -1,26 +1,26 @@
-# Lesson Logging Schema
-
-Load this file **only when writing a new lesson** at the end of a task.
-Never load at task start — it adds no value during execution.
-
-## Format
-
-Append one line per lesson to the correct domain file in `memory/lessons/`:
-
-```
-RULE: <imperative sentence — what to always do or never do> #tag YYYY-MM-DD
-```
-
-## Rules for a good entry
-
-- Start with **Always**, **Never**, or an action verb.
-- Keep it under 20 words. The rule only — no symptom narrative, no root cause prose.
-- Add one `#tag` describing the symptom class (e.g. `#build-fail`, `#wrong-path`, `#cqrs-violation`).
-- Pick the correct domain from `memory/index.md`. If unsure, use `infra.md`.
-- After appending, **increment the lesson count** for that domain in `memory/index.md`.
-
-## Example
-
-```
-RULE: Never place business logic in MediatR Handlers; delegate to domain entities or services. #cqrs-violation 2026-05-31
-```
+# Lesson Logging Schema
+
+Load this file **only when writing a new lesson** at the end of a task.
+Never load at task start — it adds no value during execution.
+
+## Format
+
+Append one line per lesson to the correct domain file in `memory/lessons/`:
+
+```
+RULE: <imperative sentence — what to always do or never do> #tag YYYY-MM-DD
+```
+
+## Rules for a good entry
+
+- Start with **Always**, **Never**, or an action verb.
+- Keep it under 20 words. The rule only — no symptom narrative, no root cause prose.
+- Add one `#tag` describing the symptom class (e.g. `#build-fail`, `#wrong-path`, `#cqrs-violation`).
+- Pick the correct domain from `memory/index.md`. If unsure, use `infra.md`.
+- After appending, **increment the lesson count** for that domain in `memory/index.md`.
+
+## Example
+
+```
+RULE: Never place business logic in MediatR Handlers; delegate to domain entities or services. #cqrs-violation 2026-05-31
+```

package/src/templates/dotnet/AgentSkills/skills/INDEX.md

@@ -6,14 +6,14 @@ Start with `AgentSkills/OPERATING.md` for the shared prerequisite and completion
 `AgentSkills/` is the single source of truth for all skills and agents.
 Do not duplicate skill content under `.github/`, `.copilot/`, `.codex/`, or other tool-specific folders.
 All AI tools and IDEs should load skills from this folder.
-
-## Skills
-
-| Skill | Load when | Path |
-|---|---|---|
-| **core** | Every task | [SKILL.md](core/SKILL.md) |
-| **code-standards** | Writing, reviewing, or refactoring C# code | [SKILL.md](code-standards/SKILL.md) |
-| **design** | Designing, architecting, or implementing patterns | [SKILL.md](design/SKILL.md) |
+
+## Skills
+
+| Skill | Load when | Path |
+|---|---|---|
+| **core** | Every task | [SKILL.md](core/SKILL.md) |
+| **code-standards** | Writing, reviewing, or refactoring C# code | [SKILL.md](code-standards/SKILL.md) |
+| **design** | Designing, architecting, or implementing patterns | [SKILL.md](design/SKILL.md) |
 | **dotnet-best-practices** | Writing, reviewing, refactoring, or optimizing .NET/C# code | [SKILL.md](dotnet-best-practices/SKILL.md) |
 | **csharp-xunit** | Get best practices for XUnit unit testing, including data-driven tests | [SKILL.md](csharp-xunit/SKILL.md) |
 | **mcp_dotnet** | Building, reviewing, or extending .NET MCP server tools, transports, and integration points | [SKILL.md](mcp_dotnet/SKILL.md) |