docs: Add descriptive comments to CI workflows

Author: ioncakephper

.github/workflows/issue-labeler.yml

@@ -1,3 +1,10 @@
+# Name: Issue Labeler Workflow
+# Description: This workflow uses the github/issue-labeler action to automatically
+#              add labels to new and edited issues based on keywords found in the
+#              issue's title and body.
+# Purpose: Automate issue triage and categorization.
+# Triggers: An issue is opened or edited.
+
 name: Issue Labeler
 
 on:

.github/workflows/release-please.yml

@@ -1,3 +1,11 @@
+# Name: Release Please Workflow
+# Description: This workflow uses the googleapis/release-please-action to automate
+#              the release process. It analyzes commits since the last release,
+#              determines the next semantic version, and creates a pull request
+#              with a changelog.
+# Purpose: Automate versioning and the creation of release pull requests.
+# Triggers: Push to the 'main' branch.
+
 name: release-please
 
 on:

.github/workflows/validate.yml

@@ -1,3 +1,10 @@
+# Name: Validate CLI Schema Workflow
+# Description: This workflow runs tests to validate the CLI schema against example
+#              YAML files. It ensures that the schema and the validation logic are
+#              working correctly.
+# Purpose: Maintain the integrity of the schema and its validation rules.
+# Triggers: Push or pull request involving changes to 'examples/*.yml' or 'schema/*.json'.
+
 name: Validate CLI Schema
 
 on: