GitHub Code Search

Search GitHub for real-world code examples and implementation patterns.

@context/blocks/construct/gh-search.md

When to Use

• Need real-world examples ("how do people implement X?")
• Exploring unfamiliar libraries/frameworks
• Comparing implementation approaches

Workflow

1. Generate Queries: Create 3-5 targeted queries

   • Language filters: language:typescript, language:go
   • Code patterns: function use, const use =
   • Config files: filename:tsconfig.json

2. Execute: Run aaa gh-search "query" for each query

3. Aggregate: Combine results, deduplicate, ensure diversity

4. Analyze: Extract imports, patterns, architectural styles

5. Report: Synthesize findings with GitHub URLs

6. Save: Write report to docs/research/github/[timestamp]-topic.md

Input: $ARGUMENTS

The search query. Can include GitHub search qualifiers:

• language:typescript
• path:src/
• extension:json

Output

# GitHub Code Search: [Topic]

## Summary
[Overview of patterns found]

## Patterns
- **[Pattern Name]**: [Description] (Refs: [repo/file](url))

## Examples
### [Approach Name]
- **Pros/Cons**: [Trade-offs]
- **Code**: [Link to file](url)

## All Files
[List of all analyzed files with GitHub URLs]