IntegratoR

Use when writing, editing, reviewing, restructuring, or deploying IntegratoR GitHub WIKI pages (the in-repo /wiki folder synced to <repo>.wiki.git) — tutorial, how-to/recipe, reference, concept/architecture, troubleshooting, release-notes, and hub prose. Enforces the code-first, one-Diataxis-mode-per-page, lean British-spelling house voice; the three-group IA (Get Started / Use Cases / Reference); Title-Case-hyphenated filenames + [Text](Slug) links; per-page "Last verified against vX" freshness stamps; rationed GitHub alert callouts; show-the-failure-path; and docs-in-lockstep-with-source grounding. Do NOT use for C# XML doc comments (see csharp-documentation) or README / CHANGELOG / ADRs.

Use when writing, reviewing, or refactoring C# in this repository — authoring a handler/service/entity/command/query, adding a test, or fixing a .cs file. Enforces IntegratoR's FluentResults Result<T> error model (never throw for business flow), async discipline (ConfigureAwait(false), CancellationToken), records-for-CQRS vs mutable-OData-entities, naming, file-scoped namespaces, British spelling (Behaviour), Central Package Management, and xUnit v3 + NSubstitute + FluentAssertions + TestKit assertions. Do NOT use for docs/wiki, JSON/config, PowerShell, or non-C# changes.

Use when writing, reviewing, trimming, or fixing CODE documentation in C# — XML doc comments (/// <summary>, <param>, <returns>, <typeparam>, <remarks>, <exception>, <inheritdoc>, <see>) and inline // comments. Enforces IntegratoR's lean-by-default doc philosophy (document the general logic concisely; inline only when truly necessary; no essays, no task/changelog narratives), 100% public coverage on packable libraries, BCL house wording, British spelling, the Result<T> failure-in-<returns> rule, and the ban on FILE-LEVEL banner comments. Do NOT use for wiki/README/architecture prose (see the /docs command) or non-C#.

Use when changing the public/published API of a NuGet-packable .NET library — adding, removing, renaming, or re-signing a public type or member; adding a parameter to an already-shipped public method; tightening what a public method accepts or changing its serialised/wire output; marking something [Obsolete]; or reviewing a PR for source, binary, or wire compatibility. Covers extend-only design, the three compatibility types, deprecation, and versioning. Do NOT use for internal-only code or an application/host with no published surface.

Use this skill AUTOMATICALLY whenever tests need to be written, planned, or reviewed — including when the user asks to "write tests", "add tests", "test this", or any variation that involves creating test code. This skill MUST run before the test-writer agent to ensure tests are planned properly, avoiding structural bloat and focusing on real behaviour. Trigger this skill when: the user asks to write, add, or create tests for any component; a new feature was implemented and needs test coverage; code was changed and you need to figure out which tests are affected; the user says "what tests do we need", "plan tests", "test strategy", "which tests break", "review test quality", "test coverage for", "write tests for", "add tests for", or any request involving test creation; after fixing a bug and needing to verify the fix is testable; when reviewing test suites for bloat or quality. This skill is the mandatory thinking step before any test writing — it produces the brief that the test-writer agent executes. Do NO

This skill should be used when the user asks to "look up docs for Polly", "find code examples for MediatR", "check FluentValidation setup", "verify library API usage", "how to configure Redis", or needs documentation or code snippets for any non-Microsoft third-party library.

This skill should be used when the user asks to "find a code sample", "check if this method exists", "verify SDK method signature", "look up Azure SDK API", "troubleshoot an SDK error", or needs to verify Microsoft API references, find working code examples, or catch hallucinated methods and deprecated patterns.

This skill should be used when the user asks to "look up Microsoft docs", "check Azure documentation", "find a .NET tutorial", "what are the limits for [service]", or needs official Microsoft Learn documentation for Azure, .NET, Microsoft 365, Power Platform, or Windows technologies — architecture overviews, quickstarts, configuration guides, limits, and best practices.