pulumi-best-practices

Pulumi Best Practices is a code-guidance skill that helps developers write, review, refactor, and debug Pulumi infrastructure-as-code programs in TypeScript and Python. It targets the subtle correctness issues that arise from Pulumi's asynchronous Output/Input model and resource dependency graph, where mistakes like creating resources inside apply() or manually unwrapping outputs lead to changes that don't appear in preview, race conditions, and incorrect deployment ordering.

The skill is organized as a set of numbered practices, each with a rationale, concrete detection signals to look for, and side-by-side wrong-versus-right code examples with links to official Pulumi documentation. Documented practices include never creating resources inside apply(), passing Outputs directly as Inputs (and using pulumi.interpolate or pulumi.concat for string composition), grouping related resources into reusable ComponentResource classes with a consistent type URN and registerOutputs(), and always setting parent: this on child resources so the component hierarchy is correct in state and the console. It ships with a use_cases.yaml and an agents/openai.yaml alongside SKILL.md, and references a companion pulumi-component skill for deeper component authoring. Its description also indicates coverage of aliases for non-destructive refactoring, secrets and config setup, and pulumi preview/up CI workflows.

It is aimed at infrastructure and platform engineers writing or reviewing Pulumi code, debugging resource dependency issues, or setting up configuration and CI. It is a read-and-advise reference authored by Pulumi; the code it contains is illustrative best-practice guidance and does not itself provision infrastructure or run destructive commands.