chore(docs): add tagging strategy documentation for Terraform modules

[virgofx]

This pull request introduces a new documentation file, tagging.md, which thoroughly explains the tagging and release strategy for Terraform modules within a monorepo. The document is intended to provide both human contributors and AI agents with a clear, detailed understanding of how the tagging, release, and cleanup processes work, as well as the rationale behind key design decisions.

Key additions in the documentation:

Tagging and Release Process Overview

• Describes how each Terraform module receives a namespaced tag (e.g., aws/vpc/v1.2.0) and a corresponding GitHub Release, using tag-only commits that are not associated with any branch. Explains the reasoning for using orphaned commits and temporary directories to keep module releases isolated and efficient.

Configuration and Conventions

• Details the tag naming convention, including customizable separators and version prefixes, and explains how tag-to-module matching is normalized to handle historical or configuration changes.
• Documents how Terraform consumers should reference tags in their source blocks, including both HTTPS and SSH formats, and how the ref parameter can be set to either the tag or commit SHA for immutability.

Lifecycle and Cleanup

• Outlines the process for identifying and deleting orphaned tags and releases when modules are removed from the monorepo, including the relevant methods and error handling strategies. (

[Copilot]

Pull request overview

This pull request adds comprehensive documentation about the tagging and release strategy for Terraform modules in a monorepo. The document is designed to provide both AI agents and human contributors with a detailed understanding of how the action creates, manages, and cleans up Git tags and GitHub Releases. The documentation covers tag naming conventions, the release creation flow, how Terraform consumers reference tags, lifecycle management, error handling, and design decisions with their rationales.

Changes:

• Adds docs/tagging.md with detailed technical documentation covering the complete tagging and release lifecycle for Terraform modules

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

[github-actions]

📋 Release Plan

Module	Type	Latest Version	New Version	Release Details
tf-modules-kms	patch		v1.0.0	🆕 Initial Release
tf-modules-vpc-endpoint	patch		v1.0.0	🆕 Initial Release

📝 Changelog

tf-modules-kms-v1.0.0 (2026-02-18)

• 🔀PR #385 - chore(docs): add tagging strategy documentation for Terraform modules

tf-modules-vpc-endpoint-v1.0.0 (2026-02-18)

• 🔀PR #385 - chore(docs): add tagging strategy documentation for Terraform modules

_{Wiki Status^ℹ️}

✅ Enabled

_{Automated Tag/Release Cleanup^ℹ️}

⏸️ Existing tags and releases will be preserved as the delete-legacy-tags flag is disabled.

_{Powered by:   techpivot/terraform-module-releaser}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.