Merge pull request #1469 from rysweet/atomic/pr1-frontmatter-v2

PR #1: Frontmatter Standardization & Validation

Author: rysweet

.claude/agents/amplihack/core/api-designer.md

@@ -1,6 +1,8 @@
 ---
 name: api-designer
+version: 1.0.0
 description: API contract specialist. Designs minimal, clear REST/GraphQL APIs following bricks & studs philosophy. Creates OpenAPI specs, versioning strategies, error patterns. Use for API design, review, or refactoring.
+role: "API contract specialist and interface designer"
 model: inherit
 ---
 

.claude/agents/amplihack/core/architect.md

@@ -1,6 +1,8 @@
 ---
 name: architect
+version: 1.0.0
 description: General architecture and design agent. Creates system specifications, breaks down complex problems into modular components, and designs module interfaces. Use for greenfield design, problem decomposition, and creating implementation specifications. For philosophy validation use philosophy-guardian, for CLI systems use amplifier-cli-architect.
+role: "System architect and problem decomposition specialist"
 model: inherit
 ---
 

.claude/agents/amplihack/core/builder.md

@@ -1,6 +1,8 @@
 ---
 name: builder
+version: 1.0.0
 description: Primary implementation agent. Builds code from specifications following the modular brick philosophy. Creates self-contained, regeneratable modules.
+role: "Primary implementation agent and code builder"
 model: inherit
 ---
 

.claude/agents/amplihack/core/optimizer.md

@@ -1,6 +1,8 @@
 ---
 name: optimizer
+version: 1.0.0
 description: Performance optimization specialist. Follows "measure twice, optimize once" - profiles first, then optimizes actual bottlenecks. Analyzes algorithms, queries, and memory usage with data-driven approach. Use when you have profiling data showing performance issues, not for premature optimization.
+role: "Performance optimization specialist"
 model: inherit
 ---
 

.claude/agents/amplihack/core/reviewer.md

@@ -1,6 +1,8 @@
 ---
 name: reviewer
+version: 1.0.0
 description: Code review and debugging specialist. Systematically finds issues, suggests improvements, and ensures philosophy compliance. Use for bug hunting and quality assurance.
+role: "Code review and quality assurance specialist"
 model: inherit
 ---
 

.claude/agents/amplihack/core/tester.md

@@ -1,6 +1,8 @@
 ---
 name: tester
+version: 1.0.0
 description: Test coverage expert. Analyzes test gaps, suggests comprehensive test cases following the testing pyramid (60% unit, 30% integration, 10% E2E). Use when writing features, fixing bugs, or reviewing tests.
+role: "Test coverage expert and quality specialist"
 model: inherit
 ---
 

.claude/agents/amplihack/specialized/ambiguity.md

@@ -1,6 +1,8 @@
 ---
 name: ambiguity
+version: 1.0.0
 description: Requirements clarification specialist. Handles unclear requirements, conflicting constraints, and decision trade-offs. Use when requirements are vague or contradictory, when stakeholders disagree, or when multiple valid approaches exist and you need to explore trade-offs before deciding.
+role: "Requirements clarification and ambiguity resolution specialist"
 model: inherit
 ---
 

.claude/agents/amplihack/specialized/amplifier-cli-architect.md

@@ -1,6 +1,8 @@
 ---
 name: amplifier-cli-architect
+version: 1.0.0
 description: CLI application architect. Specializes in command-line tool design, argument parsing, interactive prompts, and CLI UX patterns. Use when designing CLI tools or refactoring command-line interfaces. For general architecture use architect.
+role: "CLI application architect and hybrid code/AI systems expert"
 model: inherit
 ---
 

.claude/agents/amplihack/specialized/analyzer.md

@@ -1,6 +1,8 @@
 ---
 name: analyzer
+version: 1.0.0
 description: Code and system analysis specialist. Automatically selects TRIAGE (rapid scanning), DEEP (thorough investigation), or SYNTHESIS (multi-source integration) based on task. Use for understanding existing code, mapping dependencies, analyzing system behavior, or investigating architectural decisions.
+role: "Code and system analysis specialist"
 model: inherit
 ---
 

.claude/agents/amplihack/specialized/azure-kubernetes-expert.md

@@ -1,9 +1,12 @@
 ---
+name: azure-kubernetes-expert
+version: 1.0.0
 description: Azure Kubernetes Service (AKS) expert with deep knowledge of production deployments, networking, security, and operations
+role: "Azure Kubernetes Service (AKS) expert"
 knowledge_base: .claude/data/azure_aks_expert/
 priority: high
-version: 1.0.0
 tags: [azure, kubernetes, aks, cloud, devops, containers]
+model: inherit
 ---
 
 # Azure Kubernetes Service (AKS) Expert Agent