What problem does it solve? When new documentation folders, file types, or ADR naming conventions are added to a repository, the RAG index misclassifies documents and eval queries lose coverage. This Skill guides correct updates to metadata-rules.yaml and queries.yaml so documents get the right doc_kind and retrieval quality stays measurable. ## Core Features & Use Cases - Document classification rules: Add or reorder fnmatch glob rules in metadata-rules.yaml so new folders and file types receive the correct doc_kind, with specific patterns placed before broad catch-alls. - Named eval queries: Extend queries.yaml with well-formed natural-language questions, optional doc_kind and adr_id filters, and top_k overrides for eval.py coverage tracking. - Re-index guidance: Distinguish changes requiring a force-full re-index (metadata-rules) from those that do not (queries.yaml), and verify results with eval.py or query_docs. - Use Case: After adding a docs/runbooks/ folder, use this Skill to add a runbook doc_kind rule, create a coverage query for it, run a force-full re-index, and confirm retrieval with eval.py. ## Quick Start Ask the agent to add a new doc_kind rule for the docs/runbooks folder and a matching coverage query in queries.yaml, then run eval.py to verify.
