hosting-integration-authoring

name	hosting-integration-authoring
description	Guides authoring and reviewing Aspire.Hosting integration APIs. Classifies integration archetypes, then applies self-contained best practices for naming, resource shape, run/publish/deploy behavior, eventing, connection properties, security, endpoint semantics, polyglot exports, READMEs, and tests.

Aspire hosting integration authoring

Use this skill when creating, modifying, or reviewing Aspire.Hosting.* integration APIs.

This skill is self-contained. The resource files in this skill are the authoritative guidance, and repository paths are examples of existing patterns only.

First step: classify the integration

Read resources/selector-matrix.md first. Then read resources/app-model-fundamentals.md for the app model rules that apply to every hosting integration. Classify the work across all four axes:

1. Resource shape.
2. Lifecycle mode.
3. Integration role.
4. Structure.

Do not force the integration into a single bucket. Most integrations compose several patterns. For example, PostgreSQL is a container-backed service, has parent-child database resources, exposes connection properties, creates databases during resource readiness, and has admin UI companion helpers.

Then read the matching resources

Always read the relevant archetype resource and the cross-cutting resources that apply to the change.

If the integration involves	Read
Any resource, annotation, lifecycle event, structured value, endpoint, manifest, or app-model behavior	resources/app-model-fundamentals.md
Local container service, database, broker, cache, vector DB