Remove the db/connectors → tooling/db/ symlink added in Sprint 21 (#274) and migrate all references to use tooling/db/ directly. - Delete tracked symlink from db/connectors - Remove duplicate db/connectors/* permission patterns from settings - Update project-structure.md to reflect removal - Move whatsinagame/static/db/connectors/ to whatsinagame/static/tooling/db/ - Update 20 whatsinagame template, skill, and test files - Update comment references in client/tests/test_anti_tedium.gd - Historical docs (old sprint briefings, changelog, discussions) left as-is Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.9 KiB
1.9 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. | true | Bash, Read, Grep, Glob |
Search Docs Skill
Semantic search across project documents. Basic commands (qdrant-search,
qdrant-index, qdrant-health, qdrant-count) and endpoints are documented
in CLAUDE.md. This skill covers advanced operations and workflows.
Commands
Search
tooling/db/qdrant-search "search query"
Index a file
tooling/db/qdrant-index <file-path>
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
Health check
tooling/db/qdrant-health
Count documents
tooling/db/qdrant-count
Bulk Indexing
Index all project documents at once:
for f in decisions/*.md docs/discussions/*.md docs/briefings/*.md docs/*.md; do
tooling/db/qdrant-index "$f"
done
Adjust the glob patterns to match your project's document locations.
Fallback
If Qdrant or ollama is unreachable, fall back to grep-based search:
grep -r -i "search term" decisions/ docs/ --include="*.md"
Workflow
- Documenter/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