Consolidates all connector scripts under tooling/ per project structure conventions. Symlink at db/connectors → tooling/db/ preserves backwards compatibility (remove after Sprint 22). Updated references in CLAUDE.md, Makefile, DEVOPS.md, all skill files, agent files, rules, schema comments, and Sprint 21 briefings. Python scripts updated with correct SCHEMA_PATH (now relative to WORKTREE_ROOT/db/schema.sql). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.6 KiB
1.6 KiB
name, description, user-invocable, allowed-tools
| name | description | user-invocable | allowed-tools |
|---|---|---|---|
| docs-search | Search project documents using semantic search (Qdrant + ollama) or grep fallback. Use when the user asks "did we discuss X?", "find references to Y", "search docs", or invokes /docs-search. Wraps the qdrant_connector.py for semantic document search. | true | Bash, Read, Grep, Glob |
Search Docs Skill
Semantic search across project documents. Endpoints are in
.claude/rules/local-services.md. This skill covers advanced operations
and workflows.
Advanced Commands
Index a single chunk
For precise indexing of specific content:
python3 tooling/db/qdrant_connector.py index "unique-id" "Text content to index" --metadata source=manual heading="Custom heading"
Create collection
Initialize the Qdrant collection (run once during setup):
python3 tooling/db/qdrant_connector.py create-collection
Bulk Indexing
Index all project documents at once:
for f in decisions/*.md DISCUSSION.md TEAM.md docs/discussions/*.md docs/briefings/*.md; do
tooling/db/qdrant-index "$f"
done
Fallback
If Qdrant or ollama is unreachable, fall back to grep-based search:
grep -r -i "search term" decisions/ DISCUSSION.md docs/ --include="*.md"
Workflow
- Qatux (Librarian) is the primary user of this skill
- After each discussion round, index the archived round file
- After briefing updates, re-index affected briefings
- After decision changes, re-index the relevant decisions/*.md domain files
- Use search to answer "did we discuss this?" questions with citations