claude-code-workflow 6.0.0

package/.claude/workflows/cli-templates/ui-design/systems/design-tokens.json

@@ -0,0 +1,342 @@
+{
+  "$schema": "https://tr.designtokens.org/format/",
+  "name": "string - Token set name",
+  "description": "string - Token set description",
+
+  "color": {
+    "background": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" }, "$description": "optional" },
+    "foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+    "card": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+    "card-foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+    "border": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+    "input": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+    "ring": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+
+    "interactive": {
+      "primary": {
+        "default": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "hover": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "active": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "disabled": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } }
+      },
+      "secondary": {
+        "_comment": "Same structure as primary",
+        "default": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "hover": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "active": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "disabled": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } }
+      },
+      "accent": {
+        "_comment": "Same structure (no disabled state)",
+        "default": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "hover": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "active": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } }
+      },
+      "destructive": {
+        "_comment": "Same structure (no active/disabled states)",
+        "default": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "hover": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+        "foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } }
+      }
+    },
+
+    "muted": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+    "muted-foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+
+    "chart": {
+      "1": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "2": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "3": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "4": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "5": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } }
+    },
+
+    "sidebar": {
+      "background": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "primary": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "primary-foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "accent": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "accent-foreground": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "border": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } },
+      "ring": { "$type": "color", "$value": { "light": "oklch(...)", "dark": "oklch(...)" } }
+    }
+  },
+
+  "typography": {
+    "font_families": {
+      "sans": "string - 'Font Name', fallback1, fallback2",
+      "serif": "string",
+      "mono": "string"
+    },
+    "font_sizes": {
+      "xs": "0.75rem",
+      "sm": "0.875rem",
+      "base": "1rem",
+      "lg": "1.125rem",
+      "xl": "1.25rem",
+      "2xl": "1.5rem",
+      "3xl": "1.875rem",
+      "4xl": "2.25rem"
+    },
+    "line_heights": {
+      "tight": "number",
+      "normal": "number",
+      "relaxed": "number"
+    },
+    "letter_spacing": {
+      "tight": "string",
+      "normal": "string",
+      "wide": "string"
+    },
+    "combinations": [
+      {
+        "name": "h1|h2|h3|h4|h5|h6|body|caption",
+        "font_family": "sans|serif|mono",
+        "font_size": "string - reference to font_sizes",
+        "font_weight": "number - 400|500|600|700",
+        "line_height": "string",
+        "letter_spacing": "string"
+      }
+    ]
+  },
+
+  "spacing": {
+    "0": "0",
+    "1": "0.25rem",
+    "2": "0.5rem",
+    "3": "0.75rem",
+    "4": "1rem",
+    "6": "1.5rem",
+    "8": "2rem",
+    "12": "3rem",
+    "16": "4rem",
+    "20": "5rem",
+    "24": "6rem",
+    "32": "8rem",
+    "40": "10rem",
+    "48": "12rem",
+    "56": "14rem",
+    "64": "16rem"
+  },
+
+  "opacity": {
+    "disabled": "0.5",
+    "hover": "0.8",
+    "active": "1"
+  },
+
+  "shadows": {
+    "2xs": "string - CSS shadow value",
+    "xs": "string",
+    "sm": "string",
+    "DEFAULT": "string",
+    "md": "string",
+    "lg": "string",
+    "xl": "string",
+    "2xl": "string"
+  },
+
+  "border_radius": {
+    "sm": "string - calc() or fixed",
+    "md": "string",
+    "lg": "string",
+    "xl": "string",
+    "DEFAULT": "string"
+  },
+
+  "breakpoints": {
+    "sm": "640px",
+    "md": "768px",
+    "lg": "1024px",
+    "xl": "1280px",
+    "2xl": "1536px"
+  },
+
+  "component": {
+    "_comment_pattern": "COMPONENT PATTERN - Apply to: button, card, input, dialog, dropdown, toast, accordion, tabs, switch, checkbox, badge, alert",
+    "_example_button": {
+      "$type": "component",
+      "base": {
+        "_comment": "Layout properties using camelCase",
+        "display": "inline-flex|flex|block",
+        "alignItems": "center",
+        "borderRadius": "{border_radius.md}",
+        "transition": "{transitions.default}"
+      },
+      "size": {
+        "small": { "height": "32px", "padding": "{spacing.2} {spacing.3}", "fontSize": "{typography.font_sizes.xs}" },
+        "default": { "height": "40px", "padding": "{spacing.2} {spacing.4}" },
+        "large": { "height": "48px", "padding": "{spacing.3} {spacing.6}", "fontSize": "{typography.font_sizes.base}" }
+      },
+      "variant": {
+        "variantName": {
+          "default": { "backgroundColor": "{color.interactive.primary.default}", "color": "{color.interactive.primary.foreground}" },
+          "hover": { "backgroundColor": "{color.interactive.primary.hover}" },
+          "active": { "backgroundColor": "{color.interactive.primary.active}" },
+          "disabled": { "backgroundColor": "{color.interactive.primary.disabled}", "opacity": "{opacity.disabled}", "cursor": "not-allowed" },
+          "focus": { "outline": "2px solid {color.ring}", "outlineOffset": "2px" }
+        }
+      },
+      "state": {
+        "_comment": "For stateful components (dialog, accordion, etc.)",
+        "open": { "animation": "{animation.name.component-open} {animation.duration.normal} {animation.easing.ease-out}" },
+        "closed": { "animation": "{animation.name.component-close} {animation.duration.normal} {animation.easing.ease-in}" }
+      }
+    }
+  },
+
+  "elevation": {
+    "$type": "elevation",
+    "base": { "$value": "0" },
+    "overlay": { "$value": "40" },
+    "dropdown": { "$value": "50" },
+    "dialog": { "$value": "50" },
+    "tooltip": { "$value": "60" }
+  },
+
+  "_metadata": {
+    "version": "string - W3C version or custom version",
+    "created": "ISO timestamp - 2024-01-01T00:00:00Z",
+    "source": "code-import|explore|text",
+    "theme_colors_guide": {
+      "description": "Theme colors are the core brand identity colors that define the visual hierarchy and emotional tone of the design system",
+      "primary": {
+        "role": "Main brand color",
+        "usage": "Primary actions (CTAs, key interactive elements, navigation highlights, primary buttons)",
+        "contrast_requirement": "WCAG AA - 4.5:1 for text, 3:1 for UI components"
+      },
+      "secondary": {
+        "role": "Supporting brand color",
+        "usage": "Secondary actions and complementary elements (less prominent buttons, secondary navigation, supporting features)",
+        "principle": "Should complement primary without competing for attention"
+      },
+      "accent": {
+        "role": "Highlight color for emphasis",
+        "usage": "Attention-grabbing elements used sparingly (badges, notifications, special promotions, highlights)",
+        "principle": "Should create strong visual contrast to draw focus"
+      },
+      "destructive": {
+        "role": "Error and destructive action color",
+        "usage": "Delete buttons, error messages, critical warnings",
+        "principle": "Must signal danger or caution clearly"
+      },
+      "harmony_note": "All theme colors must work harmoniously together and align with brand identity. In multi-file extraction, prioritize definitions with semantic comments explaining brand intent."
+    },
+    "conflicts": [
+      {
+        "token_name": "string - which token has conflicts",
+        "category": "string - colors|typography|etc",
+        "definitions": [
+          {
+            "value": "string - token value",
+            "source_file": "string - absolute path",
+            "line_number": "number",
+            "context": "string - surrounding comment or null",
+            "semantic_intent": "string - interpretation of definition"
+          }
+        ],
+        "selected_value": "string - final chosen value",
+        "selection_reason": "string - why this value was chosen"
+      }
+    ],
+    "code_snippets": [
+      {
+        "category": "colors|typography|spacing|shadows|border_radius|component",
+        "token_name": "string - which token this snippet defines",
+        "source_file": "string - absolute path",
+        "line_start": "number",
+        "line_end": "number",
+        "snippet": "string - complete code block",
+        "context_type": "css-variable|css-class|js-object|scss-variable|etc"
+      }
+    ],
+    "usage_recommendations": {
+      "typography": {
+        "common_sizes": {
+          "small_text": "sm (0.875rem)",
+          "body_text": "base (1rem)",
+          "heading": "2xl-4xl"
+        },
+        "common_combinations": [
+          {
+            "name": "Heading + Body",
+            "heading": "2xl",
+            "body": "base",
+            "use_case": "Article sections"
+          }
+        ]
+      },
+      "spacing": {
+        "size_guide": {
+          "tight": "1-2 (0.25rem-0.5rem)",
+          "normal": "4-6 (1rem-1.5rem)",
+          "loose": "8-12 (2rem-3rem)"
+        },
+        "common_patterns": [
+          {
+            "pattern": "padding-4 margin-bottom-6",
+            "use_case": "Card content spacing",
+            "pixel_value": "1rem padding, 1.5rem margin"
+          }
+        ]
+      }
+    }
+  },
+
+  "_field_rules": {
+    "schema": "$schema MUST reference W3C Design Tokens format specification",
+    "colors": "All color values MUST use OKLCH format with light/dark mode values",
+    "types": "All tokens MUST include $type metadata (color, dimension, duration, component, elevation)",
+    "states": "Color tokens MUST include interactive states (default, hover, active, disabled) where applicable",
+    "fonts": "Typography font_families MUST include Google Fonts with fallback stacks",
+    "spacing": "Spacing MUST use systematic scale (multiples of 0.25rem base unit)",
+    "components": "Component definitions MUST be structured objects referencing other tokens via {token.path} syntax",
+    "component_states": "Component definitions MUST include state-based styling (default, hover, active, focus, disabled)",
+    "elevation": "elevation z-index values MUST be defined for layered components (overlay, dropdown, dialog, tooltip)",
+    "metadata_guide": "_metadata.theme_colors_guide RECOMMENDED in all modes to help users understand theme color roles and usage",
+    "metadata_conflicts": "_metadata.conflicts MANDATORY in Code Import mode when conflicting definitions detected",
+    "metadata_snippets": "_metadata.code_snippets ONLY present in Code Import mode",
+    "metadata_recommendations": "_metadata.usage_recommendations RECOMMENDED for universal components"
+  },
+
+  "_required_components": {
+    "_comment": "12+ components required, use pattern above",
+    "button": "5 variants (primary, secondary, destructive, outline, ghost) + 3 sizes + states (default, hover, active, disabled, focus)",
+    "card": "2 variants (default, interactive) + hover animations",
+    "input": "states (default, focus, disabled, error) + 3 sizes",
+    "dialog": "overlay + content + states (open, closed with animations)",
+    "dropdown": "trigger (references button) + content + item (with states) + states (open, closed)",
+    "toast": "2 variants (default, destructive) + states (enter, exit with animations)",
+    "accordion": "trigger + content + states (open, closed with animations)",
+    "tabs": "list + trigger (states: default, hover, active, disabled) + content",
+    "switch": "root + thumb + states (checked, disabled)",
+    "checkbox": "states (default, checked, disabled, focus)",
+    "badge": "4 variants (default, secondary, destructive, outline)",
+    "alert": "2 variants (default, destructive)"
+  },
+
+  "_token_reference_syntax": {
+    "_comment": "Use {token.path} to reference other tokens",
+    "examples": [
+      "{color.interactive.primary.default}",
+      "{spacing.4}",
+      "{typography.font_sizes.sm}"
+    ],
+    "resolution": "References are resolved during CSS generation",
+    "nested": "Supports nested references (e.g., {component.button.base})"
+  },
+
+  "_conflict_resolution_rules": {
+    "_comment": "Code Import Mode only",
+    "detect": "MUST detect when same token has different values across files",
+    "read": "MUST read semantic comments (/* ... */) surrounding definitions",
+    "prioritize": "MUST prioritize definitions with semantic intent over bare values",
+    "record": "MUST record ALL definitions in conflicts array, not just selected one",
+    "explain": "MUST explain selection_reason referencing semantic context",
+    "verify": "For core theme tokens (primary, secondary, accent): MUST verify selected value aligns with overall color scheme described in comments"
+  }
+}

package/.claude/workflows/cli-templates/ui-design/systems/layout-templates.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://tr.designtokens.org/format/",
+  "templates": [
+    {
+      "target": "string - page/component name (e.g., hero-section, product-card)",
+      "description": "string - layout description",
+      "component_type": "universal|specialized",
+      "device_type": "mobile|tablet|desktop|responsive",
+      "layout_strategy": "string - grid-3col|flex-row|stack|sidebar|etc",
+
+      "structure": {
+        "tag": "string - HTML5 semantic tag (header|nav|main|section|article|aside|footer|div|etc)",
+        "attributes": {
+          "class": "string - semantic class name",
+          "role": "string - ARIA role (navigation|main|complementary|etc)",
+          "aria-label": "string - ARIA label",
+          "aria-describedby": "string - ARIA describedby",
+          "data-state": "string - data attributes for state management (open|closed|etc)"
+        },
+        "layout": {
+          "_comment": "LAYOUT PROPERTIES ONLY - Use camelCase for property names",
+          "display": "grid|flex|block|inline-flex",
+          "grid-template-columns": "{spacing.*} or CSS value (repeat(3, 1fr))",
+          "grid-template-rows": "string",
+          "gap": "{spacing.*}",
+          "padding": "{spacing.*}",
+          "margin": "{spacing.*}",
+          "alignItems": "start|center|end|stretch",
+          "justifyContent": "start|center|end|space-between|space-around",
+          "flexDirection": "row|column",
+          "flexWrap": "wrap|nowrap",
+          "position": "relative|absolute|fixed|sticky",
+          "top": "string",
+          "right": "string",
+          "bottom": "string",
+          "left": "string",
+          "width": "string",
+          "height": "string",
+          "maxWidth": "string",
+          "minHeight": "string"
+        },
+        "responsive": {
+          "_comment": "ONLY properties that CHANGE at each breakpoint - NO repetition",
+          "sm": {
+            "grid-template-columns": "1fr",
+            "padding": "{spacing.4}"
+          },
+          "md": {
+            "grid-template-columns": "repeat(2, 1fr)",
+            "gap": "{spacing.6}"
+          },
+          "lg": {
+            "grid-template-columns": "repeat(3, 1fr)"
+          }
+        },
+        "children": [
+          {
+            "_comment": "Recursive structure - same fields as parent",
+            "tag": "string",
+            "attributes": {},
+            "layout": {},
+            "responsive": {},
+            "children": [],
+            "content": "string or {{placeholder}}"
+          }
+        ],
+        "content": "string - text content or {{placeholder}} for dynamic content"
+      },
+
+      "accessibility": {
+        "patterns": [
+          "string - ARIA patterns used (e.g., WAI-ARIA Tabs pattern, Dialog pattern)"
+        ],
+        "keyboard_navigation": [
+          "string - keyboard shortcuts (e.g., Tab/Shift+Tab navigation, Escape to close)"
+        ],
+        "focus_management": "string - focus trap strategy, initial focus target",
+        "screen_reader_notes": [
+          "string - screen reader announcements (e.g., Dialog opened, Tab selected)"
+        ]
+      },
+
+      "usage_guide": {
+        "common_sizes": {
+          "small": {
+            "dimensions": "string - e.g., px-3 py-1.5 (height: ~32px)",
+            "use_case": "string - Compact UI, mobile views"
+          },
+          "medium": {
+            "dimensions": "string - e.g., px-4 py-2 (height: ~40px)",
+            "use_case": "string - Default size for most contexts"
+          },
+          "large": {
+            "dimensions": "string - e.g., px-6 py-3 (height: ~48px)",
+            "use_case": "string - Prominent CTAs, hero sections"
+          }
+        },
+        "variant_recommendations": {
+          "variant_name": {
+            "description": "string - when to use this variant",
+            "typical_actions": ["string - action examples"]
+          }
+        },
+        "usage_context": [
+          "string - typical usage scenarios (e.g., Landing page hero, Product listing grid)"
+        ],
+        "accessibility_tips": [
+          "string - accessibility best practices (e.g., Ensure heading hierarchy, Add aria-label)"
+        ]
+      },
+
+      "extraction_metadata": {
+        "source": "code-import|explore|text",
+        "created": "ISO timestamp",
+        "code_snippets": [
+          {
+            "component_name": "string - which layout component",
+            "source_file": "string - absolute path",
+            "line_start": "number",
+            "line_end": "number",
+            "snippet": "string - complete HTML/CSS/JS code block",
+            "context_type": "html-structure|css-utility|react-component|vue-component|etc"
+          }
+        ]
+      }
+    }
+  ],
+
+  "_field_rules": {
+    "schema": "$schema MUST reference W3C Design Tokens format specification",
+    "semantic_tags": "structure.tag MUST use semantic HTML5 tags (header, nav, main, section, article, aside, footer)",
+    "aria": "structure.attributes MUST include ARIA attributes where applicable (role, aria-label, aria-describedby)",
+    "token_refs": "structure.layout MUST use {token.path} syntax for all spacing values",
+    "no_visual": "structure.layout MUST NOT include visual styling (colors, fonts, shadows - those belong in design-tokens)",
+    "layout_only": "structure.layout contains ONLY layout properties (display, grid, flex, position, spacing)",
+    "breakpoints": "structure.responsive MUST define breakpoint-specific overrides matching breakpoint tokens",
+    "no_repetition": "structure.responsive uses ONLY the properties that change at each breakpoint (no repetition)",
+    "recursive": "structure.children inherits same structure recursively for nested elements",
+    "component_type": "component_type MUST be 'universal' or 'specialized'",
+    "accessibility": "accessibility MUST include patterns, keyboard_navigation, focus_management, screen_reader_notes",
+    "usage_guide_universal": "usage_guide REQUIRED for universal components (buttons, inputs, forms, cards, navigation, etc.)",
+    "usage_guide_specialized": "usage_guide OPTIONAL for specialized components (can be simplified or omitted)",
+    "code_snippets": "extraction_metadata.code_snippets ONLY present in Code Import mode"
+  }
+}

package/.claude/workflows/context-search-strategy.md

@@ -0,0 +1,77 @@
+---
+name: context-search-strategy
+description: Strategic guidelines for context search commands
+type: search-guideline
+---
+
+# Context Search Strategy
+
+## ⚡ Execution Environment
+
+**CRITICAL**: All commands execute in **Bash environment** (Git Bash on Windows)
+
+**❌ Forbidden**: Windows commands (`findstr`, `dir`, `where`) - Use Bash (`grep`, `find`, `cat`)
+
+## ⚡ Core Search Tools
+
+**Skill()**: FASTEST way to get context - use FIRST if SKILL exists. Three types: (1) `workflow-progress` for WFS sessions (2) tech SKILLs for stack docs (3) `{project-name}` for project docs
+**codebase-retrieval**: Semantic file discovery via Gemini CLI with all files analysis
+**rg (ripgrep)**: Fast content search with regex support
+**find**: File/directory location by name patterns
+**grep**: Built-in pattern matching (fallback when rg unavailable)
+**get_modules_by_depth.sh**: Program architecture analysis (MANDATORY before planning)
+
+## 📋 Tool Selection Matrix
+
+| Need | Tool | Use Case |
+|------|------|----------|
+| **Workflow history** | Skill(workflow-progress) | WFS sessions lessons/conflicts - `/memory:workflow-skill-memory` |
+| **Tech stack docs** | Skill({tech-name}) | Stack APIs/guides - `/memory:tech-research` |
+| **Project docs** | Skill({project-name}) | Project modules/architecture - `/memory:skill-memory` |
+| **Semantic discovery** | codebase-retrieval | Find files relevant to task/feature context |
+| **Pattern matching** | rg | Search code content with regex |
+| **File name lookup** | find | Locate files by name patterns |
+| **Architecture** | get_modules_by_depth.sh | Understand program structure |
+
+## 🔧 Quick Command Reference
+
+```bash
+# SKILL Packages (FIRST PRIORITY - fastest context loading)
+Skill(command: "workflow-progress")  # Workflow: WFS sessions history, lessons, conflicts
+Skill(command: "react-dev")          # Tech: React APIs, patterns, best practices
+Skill(command: "claude_dms3")        # Project: Project modules, architecture, examples
+
+# Semantic File Discovery (codebase-retrieval)
+cd [directory] && gemini -p "
+PURPOSE: Discover files relevant to task/feature
+TASK: List all files related to [task/feature description]
+MODE: analysis
+CONTEXT: @**/*
+EXPECTED: Relevant file paths with relevance explanation
+RULES: Focus on direct relevance to task requirements
+"
+
+# Program Architecture (MANDATORY before planning)
+~/.claude/scripts/get_modules_by_depth.sh
+
+# Content Search (rg preferred)
+rg "pattern" --type js -n        # Search JS files with line numbers
+rg -i "case-insensitive"         # Ignore case
+rg -C 3 "context"                # Show 3 lines before/after
+
+# File Search
+find . -name "*.ts" -type f      # Find TypeScript files
+find . -path "*/node_modules" -prune -o -name "*.js" -print
+
+# Workflow Examples
+rg "IMPL-\d+" .workflow/ --type json                    # Find task IDs
+find .workflow/ -name "*.json" -path "*/.task/*"        # Locate task files
+rg "status.*pending" .workflow/.task/                   # Find pending tasks
+```
+
+## ⚡ Performance Tips
+
+- **rg > grep** for content search
+- **Use --type filters** to limit file types
+- **Exclude dirs**: `--glob '!node_modules'`
+- **Use -F** for literal strings (no regex)