@vodailoc/kilo-kit-mcp 1.1.0

package/skills/engineering/aspnet-core/references/security-and-identity.md

@@ -0,0 +1,75 @@
+# Security And Identity
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/security/
+- https://learn.microsoft.com/aspnet/core/security/authentication/identity
+- https://learn.microsoft.com/aspnet/core/security/authorization/introduction
+
+## Security Defaults
+
+- Use the most secure authentication flow available
+- Keep secrets out of source code and plain configuration files
+- Use Secret Manager in development
+- Use a secure production secret store
+- Enforce HTTPS
+- Apply least privilege to users, services, and data access
+
+## Authentication And Authorization
+
+Authentication answers who the user or caller is. Authorization answers what they can do.
+
+Default pipeline order:
+
+1. `UseAuthentication()`
+2. `UseAuthorization()`
+
+Apply authorization at boundaries:
+
+- `[Authorize]` on controllers, actions, page models, or hubs
+- `RequireAuthorization()` on endpoints and route groups
+- policies for reusable rules
+- roles only when role-based checks are actually the right abstraction
+
+Use `AllowAnonymous` sparingly and intentionally.
+
+## Identity
+
+Use ASP.NET Core Identity when the app needs first-party user accounts, login flows, password management, email confirmation, MFA, or related account management.
+
+Useful starting points:
+
+- `dotnet new webapp -au Individual`
+- `dotnet new mvc -au Individual`
+
+Identity guidance:
+
+- scaffold only the pages you truly need to customize
+- keep Identity UI updates maintainable; full scaffolding increases merge and upgrade cost
+- use policies and claims for authorization rather than encoding all decisions in page logic
+- persist data-protection keys appropriately in multi-instance deployments
+
+On ASP.NET Core 10, Identity metrics are available for observing auth-related behavior. Use them when the app has meaningful authentication traffic or security monitoring requirements.
+
+## CSRF, CORS, And Browser Security
+
+- Use antiforgery protection for cookie-based interactive apps and form posts
+- Do not confuse CORS with authentication or authorization
+- Avoid permissive `AllowAnyOrigin` plus credentials combinations
+- Treat browser-side state as untrusted
+
+## HTTPS, HSTS, And Forwarded Headers
+
+- redirect HTTP to HTTPS
+- enable HSTS outside development when appropriate
+- configure forwarded headers correctly when behind proxies or load balancers
+- do not generate links or evaluate scheme-sensitive behavior before proxy headers are processed
+
+## Data Protection And Secrets
+
+- persist data-protection keys outside ephemeral local storage when the app runs on multiple instances
+- do not use environment variables as the preferred long-term home for production secrets when a stronger secret store is available
+- never check production credentials into source control
+
+## Blazor Note
+
+For Blazor apps, read the general ASP.NET Core security guidance first and then the Blazor-specific security docs. Some Blazor security guidance adds to or supersedes the general guidance.

package/skills/engineering/aspnet-core/references/source-map.md

@@ -0,0 +1,43 @@
+# ASP.NET Core Source Map
+
+This skill is synthesized from the official ASP.NET Core documentation tree and overview pages. Use this file to map a task to the corresponding Microsoft Learn area before opening deeper docs.
+
+Core sources:
+
+- https://learn.microsoft.com/aspnet/core/
+- https://raw.githubusercontent.com/dotnet/AspNetCore.Docs/main/aspnetcore/toc.yml
+- https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore
+
+## Documentation Tree Mapping
+
+| ASP.NET Core docs area | Use this skill reference first |
+| --- | --- |
+| Overview, Get started, What's new | `stack-selection.md`, `versioning-and-upgrades.md` |
+| Fundamentals | `program-and-pipeline.md` |
+| Web apps | `ui-blazor.md`, `ui-razor-pages.md`, `ui-mvc.md` |
+| APIs | `apis-minimal-and-controllers.md` |
+| Real-time apps | `realtime-grpc-and-background-work.md` |
+| Remote Procedure Call apps | `realtime-grpc-and-background-work.md` |
+| Servers, Host and deploy | `testing-performance-and-operations.md` |
+| Test, Debug, Troubleshoot | `testing-performance-and-operations.md` |
+| Data access | `data-state-and-services.md` |
+| Security and Identity | `security-and-identity.md` |
+| Performance | `testing-performance-and-operations.md` |
+| Migration and updates | `versioning-and-upgrades.md` |
+
+## Areas To Consult Directly On Microsoft Learn
+
+The following topics are part of the ASP.NET Core documentation tree but are not expanded into their own dedicated reference file here:
+
+- globalization and localization
+- advanced hosting and YARP details
+- debugger and diagnostics tooling specifics
+- narrow API-reference pages for individual types
+
+When a task is dominated by one of those areas, go straight to the matching Microsoft Learn section after checking the reference files in this skill.
+
+## Practical Deep-Dive Rule
+
+- Start with the focused reference in this skill
+- If the task depends on a narrow platform detail, open the matching Learn article
+- If the task depends on version-specific behavior, confirm the correct moniker or breaking-changes page

package/skills/engineering/aspnet-core/references/stack-selection.md

@@ -0,0 +1,63 @@
+# Stack Selection
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/
+- https://learn.microsoft.com/aspnet/core/blazor/
+- https://learn.microsoft.com/aspnet/core/razor-pages/
+- https://learn.microsoft.com/aspnet/core/mvc/overview
+- https://learn.microsoft.com/aspnet/core/web-api/
+- https://learn.microsoft.com/aspnet/core/fundamentals/minimal-apis
+
+## Default Version Choice
+
+- Prefer the latest stable .NET and ASP.NET Core for new production work.
+- As of March 2026, that means `net10.0` unless the repository or user request says otherwise.
+- Treat ASP.NET Core 11 as preview. Do not adopt preview APIs by default.
+- If the repository already targets `net8.0`, `net9.0`, or another framework, stay within that target unless the task is explicitly an upgrade.
+
+## Template Short Names
+
+The current .NET 10 SDK templates include:
+
+- `dotnet new blazor`
+- `dotnet new webapp`
+- `dotnet new mvc`
+- `dotnet new webapi`
+- `dotnet new webapiaot`
+- `dotnet new grpc`
+- `dotnet new web`
+- `dotnet new razorclasslib`
+
+Verify template names with `dotnet new list` if the environment differs.
+
+## Application Model Matrix
+
+| Model | Prefer when | Watch out for | Typical starting point |
+| --- | --- | --- | --- |
+| Blazor Web App | Build full-stack .NET UI with SSR plus optional interactivity | Interactive server needs a live connection; WebAssembly increases payload size | `dotnet new blazor` |
+| Razor Pages | Build page-focused CRUD, forms, dashboards, and line-of-business apps | Authorization cannot be applied per page handler; use MVC if handler-level control matters | `dotnet new webapp` |
+| MVC | Build large server-rendered apps with clear controller/view separation, filters, and action-based patterns | More ceremony than Razor Pages for simple page flows | `dotnet new mvc` |
+| Minimal APIs | Build focused HTTP APIs, internal services, lightweight backends, and small surface areas | Route handlers can become hard to manage if business logic or metadata grows without structure | `dotnet new webapi` or `dotnet new web` |
+| Controller-based Web API | Build APIs that benefit from `[ApiController]`, content negotiation, filters, formatters, and mature controller conventions | More ceremony than Minimal APIs for small endpoints | `dotnet new webapi` |
+| SignalR | Add server push, live updates, chat, collaborative UI, or notifications | Requires connection lifecycle management and scale-out planning | Add to an existing ASP.NET Core app |
+| gRPC | Build service-to-service or streaming RPC over HTTP/2 | Browser support is different from ordinary JSON APIs; use gRPC-Web only when needed | `dotnet new grpc` |
+
+## Fast Heuristics
+
+- Choose Blazor Web App when the UI itself should be a .NET component model.
+- Choose Razor Pages when the app is mostly page and form oriented.
+- Choose MVC when actions, views, filters, and controller conventions are the center of the design.
+- Choose Minimal APIs first for small to medium HTTP services.
+- Switch to controllers when the API needs richer attribute-driven behavior, custom formatters, or strong alignment with existing MVC/Web API conventions.
+- Keep the current app model in an existing codebase unless the mismatch is causing real complexity.
+
+## Mixed-Model Guidance
+
+ASP.NET Core can mix models in one host. Common combinations:
+
+- Razor Pages or MVC for server-rendered UI plus Minimal APIs for AJAX or mobile endpoints
+- Blazor Web App plus Minimal APIs for external integration endpoints
+- MVC or Razor Pages plus SignalR for live updates
+- Web API plus gRPC for internal service-to-service calls
+
+Mix models only when it simplifies the public surface. Do not add a second app model just because ASP.NET Core allows it.

package/skills/engineering/aspnet-core/references/testing-performance-and-operations.md

@@ -0,0 +1,92 @@
+# Testing, Performance, And Operations
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/test/integration-tests
+- https://learn.microsoft.com/aspnet/core/host-and-deploy/
+- https://learn.microsoft.com/aspnet/core/host-and-deploy/health-checks
+- https://learn.microsoft.com/aspnet/core/performance/
+
+## Testing Strategy
+
+Use layered testing instead of relying on one style:
+
+- unit tests for pure services and business logic
+- integration tests for request pipeline, DI, database, auth, and framework wiring
+- browser tests for end-to-end user flows
+
+## Integration Tests
+
+Use `Microsoft.AspNetCore.Mvc.Testing` and `WebApplicationFactory<Program>` for integration tests.
+
+Guidance from the official docs:
+
+- use a test host and `HttpClient`
+- replace services with test doubles when needed
+- control redirects when asserting auth behavior
+- handle antiforgery correctly for form posts
+- prefer SQLite in-memory over the EF Core in-memory provider for more realistic database tests
+
+For SPA or browser-driven scenarios, Microsoft recommends browser automation such as Playwright for .NET.
+
+## Performance Defaults
+
+Reach for built-in features before custom optimization layers:
+
+- output caching
+- response caching where appropriate
+- response compression
+- HTTP request timeouts
+- rate limiting
+- static file handling
+
+General performance guidance:
+
+- measure first
+- keep database and network round trips visible
+- reduce payload size
+- use streaming or pagination when data is large
+- keep synchronous blocking out of hot paths
+
+## Health Checks And Observability
+
+Add health checks for dependencies that matter operationally.
+
+Use separate checks or tags when you need:
+
+- liveness
+- readiness
+- dependency-specific health surfaces
+
+Also ensure:
+
+- structured logs
+- request tracing where applicable
+- metrics for critical paths such as auth, API latency, and background work
+
+## Hosting And Deployment
+
+Typical deployment flow:
+
+1. `dotnet publish`
+2. deploy the publish output
+3. run behind a process manager
+4. place a reverse proxy in front when the environment requires it
+
+Know the deployment environment:
+
+- IIS or Windows Service on Windows
+- Kestrel plus Nginx or another reverse proxy on Linux
+- container hosting when the platform expects it
+
+Behind proxies or load balancers:
+
+- configure forwarded headers
+- validate scheme, host, and remote IP behavior
+- test auth redirects and callback URLs in the deployed topology
+
+## Operational Safeguards
+
+- add health checks for databases and critical external services
+- fail fast on invalid configuration where possible
+- keep secrets out of publish artifacts
+- verify data-protection key persistence in multi-instance deployments

package/skills/engineering/aspnet-core/references/ui-blazor.md

@@ -0,0 +1,53 @@
+# Blazor
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/blazor/
+- https://learn.microsoft.com/aspnet/core/blazor/fundamentals/
+- https://learn.microsoft.com/aspnet/core/blazor/security/
+
+## Choose Blazor Deliberately
+
+Prefer Blazor when the UI itself should be built as reusable .NET components and the team wants a full-stack .NET model.
+
+Current guidance centers on the Blazor Web App model, which can combine:
+
+- static SSR for fast first render
+- interactive server rendering
+- interactive WebAssembly rendering
+- per-component render mode choices
+
+Use standalone Blazor WebAssembly only when the app is intentionally client-heavy or must run as static files without a server-rendered host.
+
+## Render Mode Heuristics
+
+- Start with static SSR when the page is mostly read-only and fast first paint matters
+- Use interactive server rendering when you want rich interactivity without shipping the full .NET runtime to the browser
+- Use interactive WebAssembly when offline capability, client-side execution, or browser-local compute is the point
+- Mix render modes only when the split is clear and justified
+
+## Component Patterns
+
+- Keep components focused and composable
+- Move data access and business rules into injected services
+- Pass data through parameters, not hidden global state
+- Use forms and validation with Blazor's built-in editing and validation components
+- Prefer shared Razor Class Libraries for reusable component sets
+
+## Data And Interactivity
+
+- Use DI in components with restraint; avoid turning components into service locators
+- Treat JS interop as an edge mechanism for browser APIs or third-party libraries, not the primary application model
+- Keep long-running work off the UI event path
+- Be deliberate about prerendering, streaming rendering, and enhanced navigation when they improve perceived performance
+
+## Security Notes
+
+- Follow the general ASP.NET Core security guidance first, then load the Blazor-specific docs for details that supersede it
+- Remember that client-side code and browser state are not trusted
+- Keep secrets and privileged operations on the server
+- Use authorization-aware UI only as a convenience layer; enforce rules on the server as well
+
+## When Not To Use Blazor
+
+- Do not force Blazor onto a mostly conventional server-rendered app that already fits Razor Pages or MVC well
+- Do not choose WebAssembly by default for small interaction needs that SSR or interactive server rendering handles more simply

package/skills/engineering/aspnet-core/references/ui-mvc.md

@@ -0,0 +1,56 @@
+# MVC
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/mvc/overview
+- https://learn.microsoft.com/aspnet/core/mvc/controllers/
+- https://learn.microsoft.com/aspnet/core/mvc/views/
+
+## Choose MVC When Actions And Views Matter
+
+Prefer MVC when the application benefits from explicit controllers, action-based routing, filters, view models, and a strong separation between orchestration and presentation.
+
+This is often the right fit for:
+
+- large server-rendered sites
+- applications with many cross-cutting filters or action conventions
+- applications that mix views and APIs in the same controller layer
+- teams already organized around controllers and views
+
+## Core Shape
+
+Enable MVC with views using:
+
+- `builder.Services.AddControllersWithViews();`
+- `app.MapControllerRoute(...)`
+
+Keep views focused on presentation. Keep controllers focused on HTTP orchestration. Put business rules in services.
+
+## Controller Guidance
+
+- Derive from `Controller` when the controller returns views
+- Keep actions small and explicit
+- Use model binding and validation instead of manual request parsing
+- Return view models, not EF entities, to views
+- Use POST-Redirect-GET for form submissions
+
+## View Guidance
+
+- Use layouts, partial views, and Tag Helpers to keep markup consistent
+- Keep complex display logic out of Razor markup when it becomes hard to follow
+- Use strongly typed view models
+- Avoid coupling views directly to persistence models
+
+## Structure And Scale
+
+- Use areas for large bounded sections such as Admin or BackOffice
+- Keep route conventions explicit
+- Apply filters when behavior truly belongs at the MVC layer
+- Avoid giant god controllers; split by cohesive feature or resource
+
+## Choosing MVC Over Razor Pages
+
+Prefer MVC over Razor Pages when:
+
+- multiple related actions share controller-level behavior
+- handler-level authorization or action filters matter
+- URL and action design are more natural than page-file routing

package/skills/engineering/aspnet-core/references/ui-razor-pages.md

@@ -0,0 +1,55 @@
+# Razor Pages
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/razor-pages/
+- https://learn.microsoft.com/aspnet/core/tutorials/razor-pages/
+
+## Choose Razor Pages For Page-Centered Apps
+
+Prefer Razor Pages when requests naturally map to pages, forms, and page-level handlers. This is a strong default for internal tools, CRUD apps, account flows, and admin surfaces.
+
+## Core Shape
+
+Enable Razor Pages with:
+
+- `builder.Services.AddRazorPages();`
+- `app.MapRazorPages();`
+
+Use the `@page` directive to turn a `.cshtml` file into an endpoint. Keep request logic in the paired `PageModel` class when the page is more than trivial.
+
+## Routing Model
+
+- File system location defines the route by default
+- `Pages/Index.cshtml` maps to `/`
+- `Pages/Store/Index.cshtml` maps to `/Store`
+- Keep folder structure meaningful because it becomes the URL structure
+
+## PageModel Guidance
+
+- Use `OnGet`, `OnPost`, and named handlers for request processing
+- Use bindable properties and model validation for forms
+- Keep page models thin; move business logic into injected services
+- Use Tag Helpers and model binding instead of manual request parsing
+
+## Good Fits
+
+- form-heavy workflows
+- dashboards and back-office applications
+- simple content with server-side validation
+- applications where a page is the primary navigation unit
+
+## Key Limitation
+
+Do not rely on per-handler authorization with Razor Pages. Microsoft explicitly recommends using MVC controllers when different handlers on the same logical surface need different authorization behavior.
+
+Preferred responses to that limitation:
+
+- split the handlers into separate pages
+- move the surface to MVC if action-level authorization is a better fit
+
+## Organizational Guidance
+
+- Group related pages into folders
+- Use partial views for repeated fragments
+- Use areas only when the application has clear bounded sections
+- Keep shared layout and page conventions centralized

package/skills/engineering/aspnet-core/references/versioning-and-upgrades.md

@@ -0,0 +1,51 @@
+# Versioning And Upgrades
+
+Primary docs:
+- https://learn.microsoft.com/aspnet/core/release-notes/
+- https://learn.microsoft.com/aspnet/core/release-notes/aspnetcore-10.0
+- https://learn.microsoft.com/aspnet/core/release-notes/aspnetcore-9.0
+- https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/breaking-changes
+
+## Versioning Default
+
+- For new production apps in March 2026, prefer `net10.0`
+- For existing apps, match the repository's target framework unless the task is explicitly an upgrade
+- Before using a new API, confirm it exists in the target framework
+
+## Upgrade Workflow
+
+1. Identify the current target framework and SDK
+2. Read the "What's new" and breaking-changes pages for each version hop
+3. Compile and resolve obsoletions intentionally
+4. Re-run integration tests and auth flows
+5. Re-test deployment-specific behavior such as proxies, cookies, and static assets
+
+## High-Value Breaking-Change Checks
+
+When moving to ASP.NET Core 10, watch for:
+
+- cookie login redirects disabled for known API endpoints
+- `WithOpenApi` deprecation
+- `WebHostBuilder`, `IWebHost`, and `WebHost` obsolescence
+- Razor runtime compilation obsolescence
+
+When moving to ASP.NET Core 9, watch for:
+
+- `ValidateOnBuild` and `ValidateScopes` enabled in development when using `HostBuilder`
+- middleware constructor expectations and DI validation changes
+
+When moving to ASP.NET Core 8, watch for:
+
+- Minimal API `IFormFile` antiforgery requirements
+- `AddRateLimiter()` and `AddHttpLogging()` requirements when corresponding middleware is used
+
+## Migration Principles
+
+- Prefer migration to the modern hosting model when touching startup extensively
+- Remove compatibility shims only after tests confirm behavior
+- Avoid mixing new framework idioms with old startup architecture in a half-migrated state
+- Keep one authoritative target framework in project files unless multi-targeting is deliberate
+
+## Preview Feature Rule
+
+Do not introduce preview-only APIs or docs guidance unless the user explicitly asks for preview adoption or the repository is already on preview SDKs.

package/skills/engineering/backend-development/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: backend-development
+description: Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJS, FastAPI, Django), databases (PostgreSQL, MongoDB, Redis), APIs (REST, GraphQL, gRPC), authentication (OAuth 2.1, JWT), testing strategies, security best practices (OWASP Top 10), performance optimization, scalability patterns (microservices, caching, sharding), DevOps practices (Docker, Kubernetes, CI/CD), and monitoring. Use when designing APIs, implementing authentication, optimizing database queries, setting up CI/CD pipelines, handling security vulnerabilities, building microservices, or developing production-ready backend systems.
+license: MIT
+version: 1.0.0
+---
+
+# Backend Development Skill
+
+Production-ready backend development with modern technologies, best practices, and proven patterns.
+
+## When to Use
+
+- Designing RESTful, GraphQL, or gRPC APIs
+- Building authentication/authorization systems
+- Optimizing database queries and schemas
+- Implementing caching and performance optimization
+- OWASP Top 10 security mitigation
+- Designing scalable microservices
+- Testing strategies (unit, integration, E2E)
+- CI/CD pipelines and deployment
+- Monitoring and debugging production systems
+
+## Technology Selection Guide
+
+**Languages:** Node.js/TypeScript (full-stack), Python (data/ML), Go (concurrency), Rust (performance)
+**Frameworks:** NestJS, FastAPI, Django, Express, Gin
+**Databases:** PostgreSQL (ACID), MongoDB (flexible schema), Redis (caching)
+**APIs:** REST (simple), GraphQL (flexible), gRPC (performance)
+
+See: `references/backend-technologies.md` for detailed comparisons
+
+## Reference Navigation
+
+**Core Technologies:**
+- `backend-technologies.md` - Languages, frameworks, databases, message queues, ORMs
+- `backend-api-design.md` - REST, GraphQL, gRPC patterns and best practices
+
+**Security & Authentication:**
+- `backend-security.md` - OWASP Top 10 2025, security best practices, input validation
+- `backend-authentication.md` - OAuth 2.1, JWT, RBAC, MFA, session management
+
+**Performance & Architecture:**
+- `backend-performance.md` - Caching, query optimization, load balancing, scaling
+- `backend-architecture.md` - Microservices, event-driven, CQRS, saga patterns
+
+**Quality & Operations:**
+- `backend-testing.md` - Testing strategies, frameworks, tools, CI/CD testing
+- `backend-code-quality.md` - SOLID principles, design patterns, clean code
+- `backend-devops.md` - Docker, Kubernetes, deployment strategies, monitoring
+- `backend-debugging.md` - Debugging strategies, profiling, logging, production debugging
+- `backend-mindset.md` - Problem-solving, architectural thinking, collaboration
+
+## Key Best Practices (2025)
+
+**Security:** Argon2id passwords, parameterized queries (98% SQL injection reduction), OAuth 2.1 + PKCE, rate limiting, security headers
+
+**Performance:** Redis caching (90% DB load reduction), database indexing (30% I/O reduction), CDN (50%+ latency cut), connection pooling
+
+**Testing:** 70-20-10 pyramid (unit-integration-E2E), Vitest 50% faster than Jest, contract testing for microservices, 83% migrations fail without tests
+
+**DevOps:** Blue-green/canary deployments, feature flags (90% fewer failures), Kubernetes 84% adoption, Prometheus/Grafana monitoring, OpenTelemetry tracing
+
+## Quick Decision Matrix
+
+| Need | Choose |
+|------|--------|
+| Fast development | Node.js + NestJS |
+| Data/ML integration | Python + FastAPI |
+| High concurrency | Go + Gin |
+| Max performance | Rust + Axum |
+| ACID transactions | PostgreSQL |
+| Flexible schema | MongoDB |
+| Caching | Redis |
+| Internal services | gRPC |
+| Public APIs | GraphQL/REST |
+| Real-time events | Kafka |
+
+## Implementation Checklist
+
+**API:** Choose style → Design schema → Validate input → Add auth → Rate limiting → Documentation → Error handling
+
+**Database:** Choose DB → Design schema → Create indexes → Connection pooling → Migration strategy → Backup/restore → Test performance
+
+**Security:** OWASP Top 10 → Parameterized queries → OAuth 2.1 + JWT → Security headers → Rate limiting → Input validation → Argon2id passwords
+
+**Testing:** Unit 70% → Integration 20% → E2E 10% → Load tests → Migration tests → Contract tests (microservices)
+
+**Deployment:** Docker → CI/CD → Blue-green/canary → Feature flags → Monitoring → Logging → Health checks
+
+## Resources
+
+- OWASP Top 10: https://owasp.org/www-project-top-ten/
+- OAuth 2.1: https://oauth.net/2.1/
+- OpenTelemetry: https://opentelemetry.io/