feat: add argument-hint frontmatter to Claude Code commands (#1951)

Inject argument-hint into YAML frontmatter for Claude agent only during
release package generation. Templates remain agent-agnostic; hints are
added on the fly in generate_commands() when agent is "claude".

Closes #1951

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Quratulain-bilal

.github/workflows/scripts/create-release-packages.ps1

@@ -154,6 +154,25 @@ function Generate-Commands {
 
         $body = $outputLines -join "`n"
 
+        # Inject argument-hint for Claude Code commands (Claude-specific frontmatter)
+        if ($Agent -eq 'claude') {
+            $hint = switch ($name) {
+                'specify'       { 'Describe the feature you want to specify' }
+                'plan'          { 'Optional guidance for the planning phase' }
+                'tasks'         { 'Optional task generation constraints' }
+                'implement'     { 'Optional implementation guidance or task filter' }
+                'analyze'       { 'Optional focus areas for analysis' }
+                'clarify'       { 'Optional areas to clarify in the spec' }
+                'constitution'  { 'Principles or values for the project constitution' }
+                'checklist'     { 'Domain or focus area for the checklist' }
+                'taskstoissues' { 'Optional filter or label for GitHub issues' }
+                default         { '' }
+            }
+            if (-not [string]::IsNullOrEmpty($hint)) {
+                $body = $body -replace '(?m)^(description:.*)$', "`$1`nargument-hint: $hint"
+            }
+        }
+
         # Apply other substitutions
         $body = $body -replace '\{ARGS\}', $ArgFormat
         $body = $body -replace '__AGENT__', $Agent

.github/workflows/scripts/create-release-packages.sh

@@ -105,6 +105,28 @@ generate_commands() {
       { print }
     ')
 
+    # Inject argument-hint for Claude Code commands (Claude-specific frontmatter)
+    if [[ "$agent" == "claude" ]]; then
+      local hint=""
+      case "$name" in
+        specify)       hint="Describe the feature you want to specify" ;;
+        plan)          hint="Optional guidance for the planning phase" ;;
+        tasks)         hint="Optional task generation constraints" ;;
+        implement)     hint="Optional implementation guidance or task filter" ;;
+        analyze)       hint="Optional focus areas for analysis" ;;
+        clarify)       hint="Optional areas to clarify in the spec" ;;
+        constitution)  hint="Principles or values for the project constitution" ;;
+        checklist)     hint="Domain or focus area for the checklist" ;;
+        taskstoissues) hint="Optional filter or label for GitHub issues" ;;
+      esac
+      if [[ -n "$hint" ]]; then
+        body=$(printf '%s\n' "$body" | awk -v hint="$hint" '
+          /^description:/ { print; print "argument-hint: " hint; next }
+          { print }
+        ')
+      fi
+    fi
+
     # Apply other substitutions
     body=$(printf '%s\n' "$body" | sed "s/{ARGS}/$arg_format/g" | sed "s/__AGENT__/$agent/g" | rewrite_paths)