mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
25ac862f46
- Convert 40 JS files to TypeScript (CLI, tools, core, MCP server) - Add Zod for runtime parameter validation - Add type definitions in src/types/ - Keep src/templates/ as JavaScript (dashboard frontend) - Update bin entries to use dist/ - Add tsconfig.json with strict mode - Add backward-compatible exports for tests - All 39 tests passing Breaking changes: None (backward compatible) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
---
|
|
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)
|
|
|
|
|
|
|
|
## 🔧 Quick Command Reference
|
|
|
|
```bash
|
|
# 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)
|
|
ccw tool exec get_modules_by_depth '{}'
|
|
|
|
# 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)
|