release

Guides the end-to-end release workflow for Speakeasy-generated Terraform providers.

6|4|Updated Jun 22, 2023
One-click install
npx skills add https://github.com/ConductorOne/terraform-provider-conductorone --skill release-conductorone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/ConductorOne/terraform-provider-conductorone/tree/main/skills/release
Command: npx skills add https://github.com/ConductorOne/terraform-provider-conductorone --skill release-conductorone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speakeasy-generated Terraform provider releases have 7 critical manual intervention steps that code generation automation does not handle, and skipping any of these steps results in broken, misleading, or silently undocumented releases that fail in production or confuse end users.

Core Features & Use Cases

  • Step-by-step canonical release sequence: Clear, ordered workflow with explicit markers for manual vs automated steps, eliminating guesswork during version bumps and code regenerations.
  • Detailed edge case guidance: In-depth instructions for each of the 7 sharp edges, including provider registration fixes, doc emission ordering, README version lag workarounds, breaking change logging, patch tripwire extension, human-only tagging, and post-tag release note polish.
  • Pre-PR verification and templates: Built-in verification commands and a PR description template to catch issues before merge, ensuring releases are complete and consistent.
  • Use Case: For teams maintaining Speakeasy-generated Terraform providers, this skill eliminates the risk of shipping broken releases by codifying all required manual checks that are easy to miss during fast-paced regen cycles.

Quick Start

Invoke the release skill to execute the full end-to-end release workflow for the ConductorOne Terraform provider, including all mandatory manual edge checks and pre-PR verification steps.

Frequently Asked Questions about release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent broken Terraform provider releases when using Speakeasy code generation?

To prevent broken Speakeasy Terraform provider releases, you must execute a canonical release sequence that includes seven critical manual intervention steps covering version management, code regeneration, and resource registration that code generation automation does not handle automatically.

Why does my Speakeasy-generated Terraform provider have unregistered resources after a code regeneration?

Unregistered resources occur because code generation automation skips manual provider registration fixes. You must apply edge-aware release engineering workflows that explicitly mark and execute manual checks for resource registration during the regeneration cycle.

What manual steps are required for OpenAPI-spec-derived Terraform provider version management?

OpenAPI-spec-derived Terraform provider version management requires manual steps for breaking change logging, patch tripwire extension, human-only tagging, and post-tag release note polishing to ensure consistent and reliable deployments.

How do I fix stale install snippet versions in Terraform provider documentation?

Fixing stale install snippet versions in Terraform provider documentation requires applying README version lag workarounds and doc emission ordering checks before merging, ensuring documentation generation matches the current release tag.

Can I automate breaking change logging for Speakeasy Terraform providers?

Breaking change logging for Speakeasy Terraform providers cannot be fully automated by code generation. It requires a guardrailed release process with manual edge case guidance to accurately capture and document schema modifications before tagging.

What is the best way to verify a Terraform provider release before submitting a PR?

The best way to verify a Terraform provider release before submitting a PR is to run built-in verification commands and use a PR description template that catches missing documentation, broken nested schemas, and inconsistent release notes.