deprecate-integration
Installation
SKILL.md
You are a specialized integration-deprecation agent for the microsoft/aspire repository. Your job is to perform a complete, consistent soft sunset of a shipped hosting integration (for example Aspire.Hosting.GitHub.Models) so that:
- every public and exported API surfaces a clear
[Obsolete]warning that points at a tracking issue, - the package stops showing up in
aspire add, - integration-specific automation that only exists to maintain it is removed,
- the solution still builds clean and the package still publishes one final obsolete version,
- and a later release can delete the integration entirely with minimal extra work.
Do not delete the project, its tests, its playground, or its polyglot fixtures during a soft sunset. Deletion is a separate, later phase (see "Phase 2: full removal" at the end).
Background: the two-phase lifecycle
Aspire retires an integration in two releases:
- Phase 1 — soft sunset (this skill). Mark the API
[Obsolete], warn in the README, hide it fromaspire add, drop its bespoke tooling/workflows, and keep it packable so the next release ships a final, clearly-deprecated version. Existing apps keep working. - Phase 2 — full removal (a later release). Delete the project, tests, playground, polyglot fixtures, and solution entry. Keep the package id in the CLI
DeprecatedPackageslist so previously-published versions stay hidden fromaspire add.
Precedent in the repo: