Use in this personal-rag-assistant repo before implementing backend changes in main.py, config.py, rag/*.py, API wrappers, startup scripts, or tests that affect FastAPI endpoints, RAG flow, Chroma persistence, caches, model configuration, upload parsing, or external API behavior. Trigger when the user asks to modify backend logic, fix backend bugs, add API behavior, adjust persistence, or change model/RAG settings. Do not use for frontend-only Streamlit styling, project skill/docs-only changes, or read-only backend explanation unless no code will be changed.
Use in this personal-rag-assistant repo when synchronizing durable project documentation after code, API, RAG, frontend, dependency, or workflow changes. Trigger for updating AGENTS.md, BUG_LOG.md, README.md, PROJECT_MAP.md, docs/KNOWN_ISSUES.md, docs/GLOSSARY.md, docs/codex-prompts/*.md, RAG技术详解.md, or 项目维护手册.md based on real repository changes. Do not use for business-code implementation itself, short-lived notes, speculative roadmap content, or documentation that would require inventing unverified project behavior.
Use in this personal-rag-assistant repo before implementing frontend changes in streamlit_app.py, ui/sidebar.py, ui/upload.py, ui/chat.py, ui/pages.py, ui/components.py, ui/js_injection.py, ui/icons.py, or ui/styles/*. Trigger when the user asks to change Streamlit UI layout, sidebar menus, upload queue, document management, fixed chat input, theme styling, icons, status notices, or interaction behavior. Do not use for backend-only RAG/API changes, dependency work, docs-only edits, or pure verification tasks better covered by streamlit-ui-regression-check.
Use in this personal-rag-assistant repo when running minimal safe backend smoke checks for FastAPI, RAG retrieval, Chroma collection listing, SiliconFlow embedding compatibility, upload API behavior, or focused backend tests. Trigger for "后端开了吗", health checks, quick RAG sanity checks, collection/read-only API verification, or confirming a backend change did not break core flow. Do not use for destructive delete/reset operations, real data mutation, frontend-only style work, broad performance benchmarking, or full end-to-end ingestion unless explicitly requested.
Use in this personal-rag-assistant repo when debugging RAG answer quality, retrieval misses, wrong citations, empty context, query rewrite issues, reranker/compression behavior, Chroma mapping problems, or SiliconFlow embedding/generation compatibility. Trigger for RAG-specific defects across rag/qa_chain.py, rag/vector_store.py, rag/document_loader.py, rag/text_splitter.py, rag/reranker.py, rag/multimodal.py, and main.py endpoints. Do not use for frontend-only layout work, CSS cleanup, pure documentation edits, or backend infrastructure changes unrelated to retrieval/generation.
Use in this personal-rag-assistant repo when maintaining the large Streamlit CSS override system in ui/styles/*. Trigger for inspecting duplicate selectors, orphan rules, loading order, dark/mobile final refinement layers, CSS size, legacy sidebar/upload selectors, or safe cleanup opportunities after the UI is stable. Do not use for normal feature implementation, backend/RAG work, urgent broken-interaction fixes, broad visual redesigns, or changes requiring Streamlit button keys/session-state/DOM hook changes.
Use in this personal-rag-assistant repo when checking Streamlit UI regressions after edits to streamlit_app.py, ui/sidebar.py, ui/upload.py, ui/chat.py, ui/pages.py, ui/components.py, ui/js_injection.py, or ui/styles/*. Trigger for requests such as UI regression check, interaction patrol, dark/light validation, sidebar three-dot menu verification, fixed chat input verification, upload UI validation, or confirming default Streamlit alerts/progress did not reappear. Do not use for backend-only FastAPI/RAG changes, dependency upgrades, pure documentation work, or broad redesign implementation unless the user specifically asks to validate regressions.
Use in this personal-rag-assistant repo when debugging Streamlit upload queue behavior in ui/upload.py, streamlit_app.py, ui/api_wrappers.py, or related upload styles. Trigger for file removal not working, failed files reappearing, duplicate queued files, waiting/processing/success state drift, retry/reselect confusion, hidden pagination leaking, upload status not refreshing, or upload queue UI showing raw HTML/progress/default alerts. Do not use for backend-only parser failures in rag/document_loader.py, unrelated CSS cleanup, document-management bulk operations, or visual-only upload styling unless queue state behavior is involved.