feat: Add YAML frontmatter to all commands and rename ai-workflow commands

charlesjones-dev · charlesjones-dev · commit bde5868274d7 · 2025-12-10T17:37:59.000-05:00
- Add name and description YAML frontmatter to all 17 command files
- Rename ai-workflow commands with workflow- prefix for consistency:
  - plan-phases -&gt; workflow-plan-phases
  - implement-phases -&gt; workflow-implement-phases
  - preflight -&gt; workflow-preflight
- Bump all plugin versions (patch release)
- Update marketplace version to 1.6.1
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -6,15 +6,15 @@
   },
   "metadata": {
     "description": "A curated list of custom Claude Code plugins, agents, and skills for developers.",
-    "version": "1.6.0",
+    "version": "1.6.1",
     "pluginRoot": "./plugins"
   },
   "plugins": [
     {
       "name": "ai-ado",
       "source": "./plugins/ai-ado",
       "description": "AI-powered Azure DevOps integration with skills - Intelligent work item management, configuration, and automation for Azure DevOps workflows with MCP integration",
-      "version": "1.2.2",
+      "version": "1.2.3",
       "keywords": [
         "ai",
         "azure-devops",
@@ -36,7 +36,7 @@
       "name": "ai-accessibility",
       "source": "./plugins/ai-accessibility",
       "description": "AI-powered accessibility analysis - Interactive accessibility audit skill and automated agent with comprehensive WCAG compliance detection and reporting",
-      "version": "1.2.0",
+      "version": "1.2.1",
       "keywords": [
         "ai",
         "accessibility",
@@ -57,7 +57,7 @@
       "name": "ai-git",
       "source": "./plugins/ai-git",
       "description": "AI-powered git automation - Intelligent git commands and agents that streamline version control workflows with .gitignore generation",
-      "version": "1.1.1",
+      "version": "1.1.2",
       "keywords": [
         "ai",
         "git",
@@ -78,7 +78,7 @@
       "name": "ai-performance",
       "source": "./plugins/ai-performance",
       "description": "AI-powered performance optimization - Interactive performance audit skill and automated agent with comprehensive bottleneck detection and optimization",
-      "version": "1.1.2",
+      "version": "1.1.3",
       "keywords": [
         "ai",
         "performance",
@@ -98,7 +98,7 @@
       "name": "ai-plugins",
       "source": "./plugins/ai-plugins",
       "description": "AI-powered plugin and skill development - Intelligent plugin and skill scaffolding and generation tools for Claude Code",
-      "version": "1.2.2",
+      "version": "1.2.3",
       "keywords": [
         "ai",
         "plugins",
@@ -119,7 +119,7 @@
       "name": "ai-security",
       "source": "./plugins/ai-security",
       "description": "AI-powered security auditing with interactive skill, automated agents, and web dependency scanning for comprehensive vulnerability detection and reporting",
-      "version": "1.3.2",
+      "version": "1.3.3",
       "keywords": [
         "ai",
         "security",
@@ -142,7 +142,7 @@
       "name": "ai-workflow",
       "source": "./plugins/ai-workflow",
       "description": "AI-powered development workflow automation - Phase-based planning, implementation orchestration, and preflight code quality checks for efficient sub-agent execution",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "keywords": [
         "ai",
         "workflow",
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.6.1] - 2025-12-10
+
+### Changed
+
+#### All Plugins
+
+- **Added YAML frontmatter to all command files** with `name` and `description` attributes
+  - Standardizes command metadata across all 17 commands in 7 plugins
+  - Enables better command discovery and documentation
+  - Follows the pattern established by ai-workflow plugin
+
+#### AI-Workflow Plugin (v1.0.1)
+
+- **Renamed commands to use `workflow-` prefix** for consistency with other plugins
+  - `/plan-phases` → `/workflow-plan-phases`
+  - `/implement-phases` → `/workflow-implement-phases`
+  - `/preflight` → `/workflow-preflight`
+
 ## [1.6.0] - 2025-12-10
 
 ### Added
@@ -371,7 +389,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - README.md, CLAUDE.md, individual plugin READMEs, and MIT license
 
-[Unreleased]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v1.6.0...HEAD
+[Unreleased]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v1.6.1...HEAD
+[1.6.1]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v1.6.0...v1.6.1
 [1.6.0]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v1.5.4...v1.6.0
 [1.5.4]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v1.5.3...v1.5.4
 [1.5.3]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v1.5.2...v1.5.3
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # Claude Code Plugins for Developers
 
-[![Version](https://img.shields.io/badge/version-1.6.0-blue.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/releases)
+[![Version](https://img.shields.io/badge/version-1.6.1-blue.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/releases)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![GitHub Issues](https://img.shields.io/github/issues/charlesjones-dev/claude-code-plugins-dev.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/issues)
 [![GitHub Stars](https://img.shields.io/github/stars/charlesjones-dev/claude-code-plugins-dev.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/stargazers)
@@ -24,7 +24,7 @@ This Claude Code plugin marketplace provides plugins that extend Claude Code's c
 | [ai-performance](plugins/ai-performance/) | AI-powered performance optimization and bottleneck detection | `/performance-audit` | `performance-auditor` | `performance-auditing` |
 | [ai-plugins](plugins/ai-plugins/) | AI-powered plugin and skill scaffolding and generation tools | `/plugins-scaffold` | - | `skills-scaffold`, `plugins-scaffold` |
 | [ai-security](plugins/ai-security/) | AI-powered security auditing with reproducible reports | `/security-init`, `/security-audit`, `/security-scan-dependencies` | `security-auditor`, `security-dependency-scanner` | `security-auditing`, `security-dependency-scanning` |
-| [ai-workflow](plugins/ai-workflow/) | AI-powered development workflow automation | `/plan-phases`, `/implement-phases`, `/preflight` | - | `plan-phases`, `implement-phases`, `preflight-checks` |
+| [ai-workflow](plugins/ai-workflow/) | AI-powered development workflow automation | `/workflow-plan-phases`, `/workflow-implement-phases`, `/workflow-preflight` | - | `plan-phases`, `implement-phases`, `preflight-checks` |
 
 > **📝 Note on Audit Plugins:** The `ai-accessibility`, `ai-security`, and `ai-performance` plugins are developer-focused analysis tools designed to identify issues during development. They perform static code analysis, with `ai-accessibility` and `ai-security` also offering URL scanning capabilities (`/accessibility-audit` with Playwright MCP and `/security-scan-dependencies` respectively). These plugins are meant to **complement** (not replace) runtime testing tools, professional services, and manual testing. Use these plugins to catch issues early in the development phase, then validate with specialized testing tools and services appropriate to your domain.
 
diff --git a/plugins/ai-accessibility/.claude-plugin/plugin.json b/plugins/ai-accessibility/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-accessibility",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "AI-powered accessibility analysis - Interactive accessibility audit skill and automated agent with comprehensive WCAG compliance detection and reporting",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-accessibility/commands/accessibility-audit.md b/plugins/ai-accessibility/commands/accessibility-audit.md
@@ -1,3 +1,8 @@
+---
+name: accessibility-audit
+description: "Comprehensive accessibility audit to identify WCAG compliance issues and barriers to inclusive design."
+---
+
 # Accessibility Audit
 
 You are a comprehensive accessibility auditor with deep expertise in WCAG guidelines, inclusive design, assistive technologies, and accessible development practices.
diff --git a/plugins/ai-ado/.claude-plugin/plugin.json b/plugins/ai-ado/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-ado",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "AI-powered Azure DevOps integration with skills - Intelligent work item management, configuration, and automation for Azure DevOps workflows with MCP integration",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-ado/commands/ado-create-feature.md b/plugins/ai-ado/commands/ado-create-feature.md
@@ -1,3 +1,8 @@
+---
+name: ado-create-feature
+description: "Interactively create a new Feature work item in Azure DevOps using configured conventions."
+---
+
 # Create Azure DevOps Feature
 
 Interactively create a new Feature work item in Azure DevOps using the organization's configured conventions and guidelines.
diff --git a/plugins/ai-ado/commands/ado-create-story.md b/plugins/ai-ado/commands/ado-create-story.md
@@ -1,3 +1,8 @@
+---
+name: ado-create-story
+description: "Interactively create a new User Story work item as a child of an existing Feature in Azure DevOps."
+---
+
 # Create Azure DevOps User Story
 
 Interactively create a new User Story work item as a child of an existing Feature in Azure DevOps using the organization's configured conventions and guidelines.
diff --git a/plugins/ai-ado/commands/ado-create-task.md b/plugins/ai-ado/commands/ado-create-task.md
@@ -1,3 +1,8 @@
+---
+name: ado-create-task
+description: "Interactively create a new Task work item as a child of an existing User Story in Azure DevOps."
+---
+
 # Create Azure DevOps Task
 
 Interactively create a new Task work item as a child of an existing User Story in Azure DevOps using the organization's configured conventions and guidelines.
diff --git a/plugins/ai-ado/commands/ado-init.md b/plugins/ai-ado/commands/ado-init.md
@@ -1,3 +1,8 @@
+---
+name: ado-init
+description: "Initialize Azure DevOps configuration in CLAUDE.md with organization, project, and team settings."
+---
+
 # Azure DevOps Init
 
 Initialize Azure DevOps configuration by creating or updating `CLAUDE.md` with your organization, project, and team settings, and optionally configuring the Azure DevOps MCP server.
diff --git a/plugins/ai-ado/commands/ado-log-story-work.md b/plugins/ai-ado/commands/ado-log-story-work.md
@@ -1,3 +1,8 @@
+---
+name: ado-log-story-work
+description: "Rapidly log completed work to a User Story by creating a Task with completed hours already set."
+---
+
 # Log Completed Work to User Story
 
 Rapidly log completed work to a User Story by creating a new Task work item with completed hours already set. This command is designed for quick logging of work done multiple times per day.
diff --git a/plugins/ai-ado/commands/ado-timesheet-report.md b/plugins/ai-ado/commands/ado-timesheet-report.md
@@ -1,3 +1,8 @@
+---
+name: ado-timesheet-report
+description: "Generate a summarized report of hours logged from work items during a specified week."
+---
+
 # Generate Weekly Timesheet Report
 
 Generate a summarized report of hours logged from work items during a specified week, with flexible filtering options for closed, worked on, or both types of tasks. Report is organized in a hierarchical tree structure by Feature > User Story > Task.
diff --git a/plugins/ai-git/.claude-plugin/plugin.json b/plugins/ai-git/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-git",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "AI-powered git automation - Intelligent git commands and agents that streamline version control workflows with .gitignore generation",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-git/commands/git-commit-push.md b/plugins/ai-git/commands/git-commit-push.md
@@ -1,3 +1,8 @@
+---
+name: git-commit-push
+description: "Commit all changes to git with an auto-generated message and push to origin."
+---
+
 # Commit and Push
 
 Commit all changes to git and push to origin.
diff --git a/plugins/ai-git/commands/git-init.md b/plugins/ai-git/commands/git-init.md
@@ -1,3 +1,8 @@
+---
+name: git-init
+description: "Initialize .gitignore with intelligent exclusion patterns based on your project's technology stack."
+---
+
 # Git Init
 
 Initialize Git ignore patterns by creating or updating `.gitignore` with intelligent exclusion patterns based on your project's technology stack.
diff --git a/plugins/ai-performance/.claude-plugin/plugin.json b/plugins/ai-performance/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-performance",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "AI-powered performance optimization - Interactive performance audit skill and automated agent with comprehensive bottleneck detection and optimization",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-performance/commands/performance-audit.md b/plugins/ai-performance/commands/performance-audit.md
@@ -1,3 +1,8 @@
+---
+name: performance-audit
+description: "Comprehensive performance analysis to identify bottlenecks, optimization opportunities, and scalability issues."
+---
+
 # Performance Audit
 
 You are a comprehensive performance optimization expert with deep expertise in application performance, scalability, code optimization, and performance best practices.
diff --git a/plugins/ai-plugins/.claude-plugin/plugin.json b/plugins/ai-plugins/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-plugins",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "AI-powered plugin and skill development - Intelligent plugin and skill scaffolding and generation tools for Claude Code",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-plugins/commands/plugins-scaffold.md b/plugins/ai-plugins/commands/plugins-scaffold.md
@@ -1,3 +1,8 @@
+---
+name: plugins-scaffold
+description: "AI-powered plugin scaffolding tool that generates a complete Claude Code plugin structure based on user requirements."
+---
+
 # Scaffold Plugin
 
 AI-powered plugin scaffolding tool that generates a complete Claude Code plugin structure based on user requirements.
diff --git a/plugins/ai-security/.claude-plugin/plugin.json b/plugins/ai-security/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-security",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "AI-powered security auditing with interactive skill, automated agents, and web dependency scanning for comprehensive vulnerability detection and reporting",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-security/commands/security-audit.md b/plugins/ai-security/commands/security-audit.md
@@ -1,3 +1,8 @@
+---
+name: security-audit
+description: "Comprehensive security audit to identify vulnerabilities, OWASP Top 10 issues, and security anti-patterns."
+---
+
 # Security Audit
 
 You are a comprehensive security auditor with deep expertise in application security, OWASP Top 10 vulnerabilities, secure coding practices, and defensive security strategies.
diff --git a/plugins/ai-security/commands/security-init.md b/plugins/ai-security/commands/security-init.md
@@ -1,3 +1,8 @@
+---
+name: security-init
+description: "Initialize Claude Code security settings with intelligent file denial patterns based on your project's technology stack."
+---
+
 # Security Init
 
 Initialize Claude Code security settings by configuring `.claude/settings.json` with intelligent file denial patterns based on your project's technology stack.
diff --git a/plugins/ai-security/commands/security-scan-dependencies.md b/plugins/ai-security/commands/security-scan-dependencies.md
@@ -1,3 +1,8 @@
+---
+name: security-scan-dependencies
+description: "Scan a deployed website for outdated dependencies, known CVEs, and security misconfigurations."
+---
+
 # Web Dependency Security Scan
 
 Scan a deployed website for outdated dependencies, known CVEs, and security misconfigurations without requiring source code access.
diff --git a/plugins/ai-workflow/.claude-plugin/plugin.json b/plugins/ai-workflow/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "ai-workflow",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-powered development workflow automation - Phase-based planning, implementation orchestration, and preflight code quality checks for efficient sub-agent execution",
   "author": {
     "name": "Charles Jones",
diff --git a/plugins/ai-workflow/commands/workflow-implement-phases.md b/plugins/ai-workflow/commands/workflow-implement-phases.md
@@ -1,5 +1,5 @@
 ---
-name: implement-phases
+name: workflow-implement-phases
 description: "Orchestrates multi-phase implementation from a plan document using intelligent parallel/sequential execution strategy."
 ---
 
diff --git a/plugins/ai-workflow/commands/workflow-plan-phases.md b/plugins/ai-workflow/commands/workflow-plan-phases.md
@@ -1,5 +1,5 @@
 ---
-name: plan-phases
+name: workflow-plan-phases
 description: "Creates a structured implementation plan document with properly sized phases for efficient sub-agent execution."
 ---
 
diff --git a/plugins/ai-workflow/commands/workflow-preflight.md b/plugins/ai-workflow/commands/workflow-preflight.md
@@ -1,5 +1,6 @@
 ---
-description: Run code quality checks (typecheck, lint, tests) - auto-detects configured tools and offers to fix issues
+name: workflow-preflight
+description: "Run code quality checks (typecheck, lint, tests) - auto-detects configured tools and offers to fix issues."
 argument-hint: [--fix | --check-only | --verbose]
 allowed-tools: Bash, Read, Glob, Grep
 ---

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "ai-accessibility",`
`3`		`- "version": "1.2.0",`
	`3`	`+ "version": "1.2.1",`
`4`	`4`	`"description": "AI-powered accessibility analysis - Interactive accessibility audit skill and automated agent with comprehensive WCAG compliance detection and reporting",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Charles Jones",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "ai-ado",`
`3`		`- "version": "1.2.2",`
	`3`	`+ "version": "1.2.3",`
`4`	`4`	`"description": "AI-powered Azure DevOps integration with skills - Intelligent work item management, configuration, and automation for Azure DevOps workflows with MCP integration",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Charles Jones",`