القائمة
Navigate the genai-tk repository by mapping docs to code, config, tests, and existing skills. Use before making cross-cutting changes or when deciding which domain skill to load.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Build or modify LangChain, DeepAgent, DeerFlow profiles, agent tools, middleware, checkpointing, skills wiring, and the shared harness layer in genai-tk.
Work on BAML structured extraction, BAML CLI commands, processors, utilities, and Prefect BAML workflow integration in genai-tk.
Work on browser automation, sandbox browser tools, direct Playwright tools, AioSandbox backend, and sandbox CLI support in genai-tk.
Add or modify genai-tk Typer CLI commands, dynamic command registration, project scaffolding, and generated Copilot/agent support files.
Work on genai-tk OmegaConf configuration, profiles, overrides, env substitution, and config discovery. Use when editing config/*.yaml or genai_tk.config_mgmt.config_mngr.
Work on core LLM, embeddings, vector store, provider, cache, prompt, and retriever factories in genai-tk. Use when editing genai_tk/core or provider configuration.
| name | repo-map |
| description | Navigate the genai-tk repository by mapping docs to code, config, tests, and existing skills. Use before making cross-cutting changes or when deciding which domain skill to load. |
Read the closest doc first, then inspect the matching implementation paths. Do not infer behavior from filenames alone; this repo is configuration-driven and docs are the intended navigation layer.
| Work area | Read first | Then inspect |
|---|---|---|
| CLI commands | docs/cli.md, docs/scaffolding.md | genai_tk/main/cli.py, genai_tk/cli/, genai_tk/main/scaffolder.py, config/app_conf.yaml |
| Configuration | docs/configuration.md | genai_tk/utils/config_mngr.py, genai_tk/utils/config_exceptions.py, config/**/*.yaml |
| LLMs, embeddings, cache | docs/core.md, docs/llm-selection.md | genai_tk/core/, config/providers/, tests/unit_tests/core/ |
| Agents | docs/agents.md, docs/deer-flow.md | genai_tk/agents/, config/agents/, tests/unit_tests/agents/ |
| Agent middleware | docs/middleware-pii-and-routing.md | genai_tk/agents/langchain/middleware/, tests/unit_tests/agents/langchain/middleware/ |
| RAG | docs/rag.md | genai_tk/core/retrievers/, genai_tk/workflow/rag/, config/rag.yaml, tests/unit_tests/core/test_retriever_factory.py |
| Workflows and Prefect | docs/workflows.md, docs/prefect.md | genai_tk/workflow/, genai_tk/workflow/prefect/, config/workflows.yaml |
| MCP exposure | docs/mcp-servers.md | genai_tk/mcp/, config/examples/tk_servers.yaml, tests/unit_tests/mcp/ |
| Browser automation | docs/browser_control.md, docs/sandbox_support.md | genai_tk/agents/tools/sandbox_browser/, genai_tk/agents/tools/direct_browser/, genai_tk/agents/sandbox/ |
| Webapp | docs/webapp.md | genai_tk/webapp/, config/webapp.yaml |
| BAML | docs/baml.md | genai_tk/extra/structured/, genai_tk/workflow/prefect/flows/baml_flow.py |
| Evaluation/testing | docs/TESTING_GUIDE.md, docs/evaluation_testing.md | tests/, pyproject.toml dependency groups |
genai_tk.*.uv run ... for commands and tests.tests/unit_tests/<domain>/ path first; use integration tests only when behavior requires real services or CLI wiring.uv run pytest tests/unit_tests/core -q
uv run pytest tests/unit_tests/agents -q
uv run pytest tests/unit_tests/workflow -q
uv run pytest tests/unit_tests/mcp -q
uv run pytest tests/unit_tests/cli -q
Run make lint before finishing code changes that touch Python.