Alex Newman
ca4f046777
Enhancements: - Added search skill with 10 HTTP API endpoints for memory queries - Refactored version-bump and troubleshoot skills using progressive disclosure pattern - Added operations/ subdirectories for detailed skill documentation - Updated CLAUDE.md with skill-based search architecture - Enhanced worker service with search API endpoints - Updated CHANGELOG.md with v5.4.0 migration details Technical changes: - New plugin/skills/search/ directory with SKILL.md - New .claude/skills/version-bump/operations/ (workflow.md, scenarios.md) - New plugin/skills/troubleshoot/operations/ (common-issues.md, worker.md) - Modified src/services/worker-service.ts (added search endpoints) - Modified plugin/scripts/worker-service.cjs (rebuilt with search API) - Reduced main skill files by 89% using progressive disclosure - Token savings: ~2,250 tokens per session start 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
67 lines
1.8 KiB
Markdown
67 lines
1.8 KiB
Markdown
# Search by Concept
|
|
|
|
Find observations tagged with specific concepts.
|
|
|
|
## When to Use
|
|
|
|
- Looking for observations about a specific concept
|
|
- Understanding patterns across the codebase
|
|
- Finding related learnings
|
|
|
|
## Command
|
|
|
|
```bash
|
|
curl -s "http://localhost:37777/api/search/by-concept?concept=discovery&limit=5&format=index"
|
|
```
|
|
|
|
## Parameters
|
|
|
|
- **concept** (required): Concept tag to search for
|
|
- **format**: "index" or "full" (default: "full")
|
|
- **limit**: Number of results (default: 10, max: 100)
|
|
- **project**: Filter by project name (optional)
|
|
|
|
## Common Concepts
|
|
|
|
- **discovery**: Learnings and findings
|
|
- **decision**: Choices and rationale
|
|
- **architecture**: System design
|
|
- **performance**: Speed and optimization
|
|
- **security**: Security considerations
|
|
- **testing**: Test-related work
|
|
- **how-it-works**: Implementation details
|
|
- **why-it-exists**: Rationale and context
|
|
- **gotcha**: Tricky issues or edge cases
|
|
- **pattern**: Reusable patterns
|
|
|
|
## Use Case
|
|
|
|
"What have we learned about the database?" → Search concept=discovery + keyword search for "database"
|
|
|
|
You can combine concept search with keyword search:
|
|
```bash
|
|
# First get observations with concept=discovery
|
|
curl -s "http://localhost:37777/api/search/by-concept?concept=discovery&limit=20&format=index"
|
|
# Then filter results for "database" mentions
|
|
```
|
|
|
|
## How to Present Results
|
|
|
|
```markdown
|
|
Found 5 discoveries:
|
|
|
|
1. 🔵 **#1230** Database connection pooling best practices
|
|
> Learned that pool size should match CPU cores * 2
|
|
> Nov 8, 2024 • api-server
|
|
|
|
2. 🔵 **#1231** JWT library comparison
|
|
> Evaluated 3 libraries: jsonwebtoken, jose, passport-jwt
|
|
> Nov 8, 2024 • api-server
|
|
```
|
|
|
|
## Tips
|
|
|
|
1. Concepts provide semantic grouping beyond full-text search
|
|
2. Useful for finding patterns across different parts of work
|
|
3. Combine with full-text search for precise results
|