Add rag-search skill for semantic search #6

Closed
will wants to merge 0 commits from feature/agentic-rag into main
Owner

Summary

  • Add new rag-search skill for semantic search across personal state files and external documentation
  • Uses ChromaDB for vector storage and sentence-transformers (all-MiniLM-L6-v2) for embeddings
  • Two indexes: personal (state files) and docs (external documentation like k0s)
  • All 5 tests passing

Components

Script Purpose
search.py Main search interface with --index and --top-k flags
index_personal.py Index ~/.claude/state files (116 chunks)
index_docs.py Index external docs from git repos (k0s: 846 chunks)
add_doc_source.py Manage documentation sources
test_rag.py Test suite

Documentation Updates

  • Added skill to component-registry.json with triggers
  • Added /rag command alias
  • Updated skills/README.md
  • Resolved fc-013 (vector database for agent memory)
  • Added data/ and venv to .gitignore

Test plan

  • ChromaDB + embeddings working
  • Personal index populated from ~/.claude/state
  • At least one external doc source indexed (k0s)
  • search.py returns relevant results
  • All tests pass (5/5)

🤖 Generated with Claude Code

## Summary - Add new `rag-search` skill for semantic search across personal state files and external documentation - Uses ChromaDB for vector storage and sentence-transformers (all-MiniLM-L6-v2) for embeddings - Two indexes: `personal` (state files) and `docs` (external documentation like k0s) - All 5 tests passing ## Components | Script | Purpose | |--------|---------| | `search.py` | Main search interface with `--index` and `--top-k` flags | | `index_personal.py` | Index `~/.claude/state` files (116 chunks) | | `index_docs.py` | Index external docs from git repos (k0s: 846 chunks) | | `add_doc_source.py` | Manage documentation sources | | `test_rag.py` | Test suite | ## Documentation Updates - Added skill to `component-registry.json` with triggers - Added `/rag` command alias - Updated `skills/README.md` - Resolved `fc-013` (vector database for agent memory) - Added `data/` and venv to `.gitignore` ## Test plan - [x] ChromaDB + embeddings working - [x] Personal index populated from ~/.claude/state - [x] At least one external doc source indexed (k0s) - [x] search.py returns relevant results - [x] All tests pass (5/5) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
will added 2 commits 2026-01-05 07:43:14 +00:00
Design for extending Claude agent system with semantic search:
- Two indexes: personal (state files) + external docs
- ChromaDB + sentence-transformers stack
- rag-search skill with search.py CLI
- Daily systemd timer for index refresh
- Ralph loop implementation with Haiku/Sonnet delegation

Added future considerations (fc-043 to fc-046):
- Auto-sync on tool version change
- Broad doc indexing
- K8s deployment
- Query caching

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add new skill for semantic search across personal state files and
external documentation using ChromaDB and sentence-transformers.

Components:
- search.py: Main search interface (--index, --top-k flags)
- index_personal.py: Index ~/.claude/state files
- index_docs.py: Index external docs (git repos)
- add_doc_source.py: Manage doc sources
- test_rag.py: Test suite (5/5 passing)

Features:
- Two indexes: personal (116 chunks) and docs (k0s: 846 chunks)
- all-MiniLM-L6-v2 embeddings (384 dimensions)
- ChromaDB persistent storage
- JSON output with ranked results and metadata

Documentation:
- Added to component-registry.json with triggers
- Added /rag command alias
- Updated skills/README.md
- Resolved fc-013 (vector database for agent memory)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
will added 4 commits 2026-01-05 07:45:45 +00:00
- Add is_section_enabled() to support per-section enable/disable in config
- Update Python path from 3.13 to 3.14 for gmail venv
- Disable tasks section by default (enabled: false in config)
- Apply code formatting improvements (black/ruff style)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
will closed this pull request 2026-01-05 07:48:40 +00:00

Pull request closed

Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: will/claude-code#6
No description provided.