docs(guide): add YAML frontmatter to 15 workflow guide files

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

guide/workflows/README.md

@@ -1,3 +1,9 @@
+---
+title: "Claude Code Workflows"
+description: "Step-by-step guides for common development patterns with Claude Code"
+tags: [workflow, guide, reference]
+---
+
 # Claude Code Workflows
 
 Step-by-step guides for common development patterns with Claude Code.

guide/workflows/agent-teams-quick-start.md

@@ -1,3 +1,9 @@
+---
+title: "Agent Teams Quick Start Guide"
+description: "Practical 5-minute setup guide with copy-paste patterns for agent teams"
+tags: [workflow, agents, tutorial]
+---
+
 # Agent Teams Quick Start Guide
 
 > **Practical guide for using agent teams in your projects**

guide/workflows/agent-teams.md

@@ -1,3 +1,9 @@
+---
+title: "Agent Teams Workflow"
+description: "Multi-agent parallel coordination for complex tasks with autonomous team lead"
+tags: [workflow, agents, architecture]
+---
+
 # Agent Teams Workflow
 
 > **Multi-agent parallel coordination for complex tasks**

guide/workflows/design-to-code.md

@@ -1,3 +1,9 @@
+---
+title: "Design-to-Code Workflow with Figma MCP"
+description: "Automated design system implementation using Figma MCP Server for 1:1 design-code parity"
+tags: [workflow, mcp, integration]
+---
+
 # Design-to-Code Workflow with Figma MCP
 
 > **Confidence**: Tier 2 — Based on documented production case studies (Parallel HQ, builder.io), MCP server specifications, and community workflows.

guide/workflows/dual-instance-planning.md

@@ -1,3 +1,9 @@
+---
+title: "Dual-Instance Planning Workflow"
+description: "Use two Claude instances with distinct roles for planning and implementation"
+tags: [workflow, architecture, design-patterns]
+---
+
 # Dual-Instance Planning Workflow
 
 > **Confidence**: Tier 2 — Based on practitioner experience (Jon Williams, Feb 2026). Pattern validated through personal transition Cursor → Claude Code over 6 months.

guide/workflows/exploration-workflow.md

@@ -1,3 +1,9 @@
+---
+title: "Exploration Before Implementation"
+description: "Ask Claude for multiple approaches with trade-offs before coding to prevent anchoring bias"
+tags: [workflow, architecture, design-patterns]
+---
+
 # Exploration Before Implementation
 
 > **Confidence**: Tier 2 — Validated by practitioner studies (+20-30% decision quality, +40% alternatives identified).

guide/workflows/iterative-refinement.md

@@ -1,3 +1,9 @@
+---
+title: "Iterative Refinement"
+description: "Prompt, observe, and reprompt until satisfied — the core loop of AI-assisted development"
+tags: [workflow, guide, design-patterns]
+---
+
 # Iterative Refinement
 
 > **Confidence**: Tier 2 — Validated pattern observed across many Claude Code users.

guide/workflows/pdf-generation.md

@@ -1,3 +1,9 @@
+---
+title: "PDF Generation with Claude Code"
+description: "Generate professional PDFs using Claude Code with Quarto and Typst stack"
+tags: [workflow, guide, integration]
+---
+
 # PDF Generation with Claude Code
 
 > **Confidence**: Tier 2 — Based on production-tested workflow with Quarto/Typst stack.

guide/workflows/plan-driven.md

@@ -1,3 +1,9 @@
+---
+title: "Plan-Driven Development"
+description: "Use /plan mode for non-trivial tasks to explore and propose implementation plans"
+tags: [workflow, guide, architecture]
+---
+
 # Plan-Driven Development
 
 > **Confidence**: Tier 1 — Based on Claude Code's native /plan mode functionality.

guide/workflows/search-tools-mastery.md

@@ -1,3 +1,9 @@
+---
+title: "Search Tools Mastery: Combining rg, grepai, Serena & ast-grep"
+description: "Master code search by combining the right tools for maximum efficiency"
+tags: [workflow, search, guide, mcp]
+---
+
 # Search Tools Mastery: Combining rg, grepai, Serena & ast-grep
 
 > **Master the art of code search by combining the right tools for maximum efficiency**

guide/workflows/skeleton-projects.md

@@ -1,3 +1,9 @@
+---
+title: "Skeleton Projects Workflow"
+description: "Use existing battle-tested repositories as scaffolding for new projects"
+tags: [workflow, architecture, template]
+---
+
 # Skeleton Projects Workflow
 
 Use existing, battle-tested repositories as scaffolding for new projects instead of starting from scratch.

guide/workflows/spec-first.md

@@ -1,3 +1,9 @@
+---
+title: "Spec-First Development with Claude"
+description: "Define specifications in CLAUDE.md before implementation for structured development"
+tags: [workflow, architecture, config]
+---
+
 # Spec-First Development with Claude
 
 > **Confidence**: Tier 2 — Validated by multiple production teams and aligns with official SDD guidance.

guide/workflows/task-management.md

@@ -1,3 +1,9 @@
+---
+title: "Task Management Workflow"
+description: "Multi-session task coordination using Tasks API and TodoWrite for complex projects"
+tags: [workflow, guide, agents]
+---
+
 # Task Management Workflow
 
 **Version**: Claude Code v2.1.16+

guide/workflows/tdd-with-claude.md

@@ -1,3 +1,9 @@
+---
+title: "TDD with Claude Code"
+description: "Test-Driven Development workflow with explicit prompting for red-green-refactor cycles"
+tags: [workflow, tdd, testing]
+---
+
 # TDD with Claude Code
 
 > **Confidence**: Tier 1 — Based on official Anthropic best practices and extensive community validation.

guide/workflows/tts-setup.md

@@ -1,3 +1,9 @@
+---
+title: "TTS Setup Workflow - Agent Vibes Installation"
+description: "Add text-to-speech narration to Claude Code on macOS"
+tags: [workflow, tts, tutorial]
+---
+
 # TTS Setup Workflow - Agent Vibes Installation
 
 **Goal**: Add text-to-speech narration to Claude Code