# C# 14 / .NET 10 AI Agent Skill Pack

This repository contains a routable `AGENTS.md` plus modular skill files for AI coding agents working on C# and .NET projects.

The skills summarize and operationalize concepts, principles, rules, and best practices extracted from the uploaded book *C# 14 and .NET 10 - Modern Cross-Platform Development Fundamentals, Tenth Edition* by Mark J. Price, with added expert-agent workflow structure for practical coding use.

## Structure

```text
.
├── AGENTS.md
├── README.md
├── manifest.json
├── docs/
│   ├── concept-map.md
│   ├── review-checklist.md
│   ├── task-routing.md
│   └── unit-of-work-pattern.md
└── .ai/
    ├── SKILLS.md
    ├── prompts/
    │   └── csharp-dotnet-agent-prompt.md
    └── skills/
        ├── 00-agent-operating-rules.md
        ├── 01-dotnet-platform-tooling.md
        ├── 02-csharp-language-fundamentals.md
        ├── 03-types-values-nullability.md
        ├── 04-control-flow-exceptions.md
        ├── 05-functions-debugging-testing.md
        ├── 06-oop-types-records.md
        ├── 07-interfaces-generics-events-inheritance.md
        ├── 08-common-dotnet-types.md
        ├── 09-files-streams-serialization.md
        ├── 10-ef-core-data-access.md
        ├── 11-linq-querying.md
        ├── 12-aspnetcore-web-fundamentals.md
        ├── 13-blazor-components.md
        ├── 14-minimal-api-web-services.md
        ├── 15-packaging-publishing-nuget-aot.md
        ├── 16-security-reliability-performance.md
        ├── 17-code-review-definition-of-done.md
        └── 18-unit-of-work-pattern.md
```

## How an AI agent should use this pack

1. Read `AGENTS.md` first.
2. Read `.ai/SKILLS.md` next.
3. Load only the skill files relevant to the current task.
4. Follow the checklists in `docs/review-checklist.md` before returning final code.

## Notes

This pack is intentionally modular. Keep `AGENTS.md` short and use `.ai/SKILLS.md` as the router. Add project-specific skills under `.ai/skills/project/` when needed.

Skill `18-unit-of-work-pattern.md` covers the generic Unit of Work and repository pattern. Load it when a task involves `IUnitOfWork`, `UnitOfWork`, `GenericRepository<T>`, EF Core `DbContext` transaction boundaries, or repository-backed services and controllers. See `docs/unit-of-work-pattern.md` for a concise reference summary.