From 624b2e0425534ed588111340afce7b5f1fbeaeb4 Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Sun, 15 Feb 2026 19:20:35 +0100 Subject: [PATCH] docs(guide): add YAML frontmatter to 15 workflow guide files Co-Authored-By: Claude Opus 4.6 --- guide/workflows/README.md | 6 ++++++ guide/workflows/agent-teams-quick-start.md | 6 ++++++ guide/workflows/agent-teams.md | 6 ++++++ guide/workflows/design-to-code.md | 6 ++++++ guide/workflows/dual-instance-planning.md | 6 ++++++ guide/workflows/exploration-workflow.md | 6 ++++++ guide/workflows/iterative-refinement.md | 6 ++++++ guide/workflows/pdf-generation.md | 6 ++++++ guide/workflows/plan-driven.md | 6 ++++++ guide/workflows/search-tools-mastery.md | 6 ++++++ guide/workflows/skeleton-projects.md | 6 ++++++ guide/workflows/spec-first.md | 6 ++++++ guide/workflows/task-management.md | 6 ++++++ guide/workflows/tdd-with-claude.md | 6 ++++++ guide/workflows/tts-setup.md | 6 ++++++ 15 files changed, 90 insertions(+) diff --git a/guide/workflows/README.md b/guide/workflows/README.md index e39dda1..9599cbc 100644 --- a/guide/workflows/README.md +++ b/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. diff --git a/guide/workflows/agent-teams-quick-start.md b/guide/workflows/agent-teams-quick-start.md index d889126..42e3977 100644 --- a/guide/workflows/agent-teams-quick-start.md +++ b/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** diff --git a/guide/workflows/agent-teams.md b/guide/workflows/agent-teams.md index a81d87b..98c90fa 100644 --- a/guide/workflows/agent-teams.md +++ b/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** diff --git a/guide/workflows/design-to-code.md b/guide/workflows/design-to-code.md index 5520f19..176eb31 100644 --- a/guide/workflows/design-to-code.md +++ b/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. diff --git a/guide/workflows/dual-instance-planning.md b/guide/workflows/dual-instance-planning.md index f461548..82d00f1 100644 --- a/guide/workflows/dual-instance-planning.md +++ b/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. diff --git a/guide/workflows/exploration-workflow.md b/guide/workflows/exploration-workflow.md index b347dfe..3b237fc 100644 --- a/guide/workflows/exploration-workflow.md +++ b/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). diff --git a/guide/workflows/iterative-refinement.md b/guide/workflows/iterative-refinement.md index fc18b04..9989f32 100644 --- a/guide/workflows/iterative-refinement.md +++ b/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. diff --git a/guide/workflows/pdf-generation.md b/guide/workflows/pdf-generation.md index 6b570bf..12b1549 100644 --- a/guide/workflows/pdf-generation.md +++ b/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. diff --git a/guide/workflows/plan-driven.md b/guide/workflows/plan-driven.md index dcb0648..22f1c29 100644 --- a/guide/workflows/plan-driven.md +++ b/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. diff --git a/guide/workflows/search-tools-mastery.md b/guide/workflows/search-tools-mastery.md index dcd8681..711de32 100644 --- a/guide/workflows/search-tools-mastery.md +++ b/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** diff --git a/guide/workflows/skeleton-projects.md b/guide/workflows/skeleton-projects.md index 853a280..47a803e 100644 --- a/guide/workflows/skeleton-projects.md +++ b/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. diff --git a/guide/workflows/spec-first.md b/guide/workflows/spec-first.md index c21adb5..5d3c137 100644 --- a/guide/workflows/spec-first.md +++ b/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. diff --git a/guide/workflows/task-management.md b/guide/workflows/task-management.md index 9f3652f..65da46f 100644 --- a/guide/workflows/task-management.md +++ b/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+ diff --git a/guide/workflows/tdd-with-claude.md b/guide/workflows/tdd-with-claude.md index def782b..4b1b3ee 100644 --- a/guide/workflows/tdd-with-claude.md +++ b/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. diff --git a/guide/workflows/tts-setup.md b/guide/workflows/tts-setup.md index d7b020a..808764d 100644 --- a/guide/workflows/tts-setup.md +++ b/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