docs: add search tools guides and ast-grep patterns

New documentation:
- guide/search-tools-cheatsheet.md: Quick reference for Grep/Glob/Read tools
- guide/workflows/README.md: Workflows directory index
- examples/skills/ast-grep-patterns.md: AST-based code search patterns

Updated:
- guide/architecture.md: MCP architecture visual diagram section

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

guide/workflows/README.md

@@ -0,0 +1,122 @@
+# Claude Code Workflows
+
+Step-by-step guides for common development patterns with Claude Code.
+
+---
+
+## 🔍 Search & Discovery
+
+### [Search Tools Mastery](./search-tools-mastery.md) ⭐ NEW
+
+**Master the art of code search by combining rg, grepai, Serena & ast-grep**
+
+Learn when to use each tool, how to combine them for maximum efficiency, and real-world workflows including:
+- Exploring unknown codebases
+- Large-scale refactoring
+- Security audits
+- Framework migrations
+- Performance optimization
+
+**Key Topics**:
+- Quick decision matrix
+- Complete feature comparison
+- 5 combined workflows
+- Performance benchmarks
+- Common pitfalls
+- Tool selection cheatsheet
+
+---
+
+## 🎯 Development Workflows
+
+### [Plan-Driven Development](./plan-driven.md)
+
+Structure complex tasks with planning mode before execution.
+
+**When to use**: Multi-step features, architectural changes, uncertainty about approach
+
+### [TDD with Claude](./tdd-with-claude.md)
+
+Test-Driven Development workflow: write tests first, implement after.
+
+**When to use**: Critical functionality, regression prevention, API design
+
+### [Spec-First Development](./spec-first.md)
+
+Write specifications before code for better requirements clarity.
+
+**When to use**: Team collaboration, complex features, documentation-first projects
+
+### [Iterative Refinement](./iterative-refinement.md)
+
+Improve code through multiple refinement cycles.
+
+**When to use**: Quality improvements, performance optimization, code cleanup
+
+---
+
+## 🎨 Design & Content
+
+### [Design to Code](./design-to-code.md)
+
+Convert design mockups (Figma, wireframes) into working code.
+
+**When to use**: Frontend development, UI implementation, design system work
+
+### [PDF Generation](./pdf-generation.md)
+
+Generate professional PDFs using Quarto/Typst with Claude Code.
+
+**When to use**: Reports, documentation, whitepapers, technical documents
+
+### [TTS Setup](./tts-setup.md)
+
+Configure Text-to-Speech for Claude Code responses (Agent Vibes integration).
+
+**When to use**: Audio feedback, accessibility, hands-free coding
+
+---
+
+## 🔬 Code Exploration
+
+### [Exploration Workflow](./exploration-workflow.md)
+
+Systematically explore and understand unfamiliar codebases.
+
+**When to use**: New projects, legacy code, documentation gaps
+
+**Related**: See [Search Tools Mastery](./search-tools-mastery.md) for advanced multi-tool exploration strategies.
+
+---
+
+## Quick Selection Guide
+
+| Your Situation | Recommended Workflow |
+|----------------|---------------------|
+| **New to codebase** | [Exploration Workflow](./exploration-workflow.md) + [Search Tools Mastery](./search-tools-mastery.md) |
+| **Complex feature** | [Plan-Driven](./plan-driven.md) or [Spec-First](./spec-first.md) |
+| **Need reliability** | [TDD with Claude](./tdd-with-claude.md) |
+| **Large refactoring** | [Search Tools Mastery](./search-tools-mastery.md) |
+| **UI implementation** | [Design to Code](./design-to-code.md) |
+| **Code quality** | [Iterative Refinement](./iterative-refinement.md) |
+| **Documentation** | [PDF Generation](./pdf-generation.md) |
+| **Audio feedback** | [TTS Setup](./tts-setup.md) |
+
+---
+
+## Contributing
+
+New workflow ideas? Open an issue or PR in the main repository.
+
+**Workflow Template Structure**:
+1. Title & Purpose
+2. When to Use
+3. Prerequisites
+4. Step-by-Step Guide
+5. Real-World Examples
+6. Common Pitfalls
+7. Related Workflows
+
+---
+
+**Last updated**: January 2026