002f9879b2
Replaces cherry-picked upstream_ref with complete source trees. xllm/ — Iluvatar official C++ inference engine (15MB, 1470 files) Complete: kernels → layers → models → runtime → scheduler → api Excluded: .git, binary images, third_party submodule checkouts ds_vllm/ — Iluvatar official vllm fork (8MB, 703 files) Included: csrc/ (ALL CUDA kernels), fused_moe/, qwen3_5 model, _custom_ops Excluded: tests, benchmarks, docs, examples (not needed for reference) Critical call chains now fully traceable: MoE: moe_topk_softmax_kernels.cuh → ixformer.h → fused_moe.cpp → layer GDN: qwen3_gated_delta_net_base.cpp → qwen3_5_gated_delta_net.cpp Attention: ixformer.h → xllm_paged_attention → attention.cpp
51 lines
3.3 KiB
Markdown
51 lines
3.3 KiB
Markdown
# xLLM Coding Agent Instructions
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
├── xllm/
|
|
| : main source folder
|
|
│ ├── api_service/ # code for api services
|
|
│ ├── c_api/ # code for c api
|
|
│ ├── cc_api/ # code for cc api
|
|
│ ├── core/
|
|
│ │ : xllm core features folder
|
|
│ │ ├── common/
|
|
│ │ ├── distributed_runtime/ # code for distributed and pd serving
|
|
│ │ ├── framework/ # code for execution orchestration
|
|
│ │ ├── kernels/ # adaption for npu kernels adaption
|
|
│ │ ├── layers/ # model layers impl
|
|
│ │ ├── platform/ # adaption for various platform
|
|
│ │ ├── runtime/ # code for worker and executor
|
|
│ │ ├── scheduler/ # code for batch and pd scheduler
|
|
│ │ └── util/
|
|
│ ├── function_call # code for tool call parser
|
|
│ ├── models/ # models impl
|
|
│ ├── parser/ # parser reasoning
|
|
│ ├── processors/ # code for vlm pre-processing
|
|
│ ├── proto/ # communication protocol
|
|
│ ├── pybind/ # code for python bind
|
|
| └── server/ # xLLM server
|
|
├── examples/ # examples of calling xLLM
|
|
├── tools/ # code for npu time generations
|
|
└── xllm.cpp # entrypoint of xLLM
|
|
```
|
|
|
|
## Code Style Guide
|
|
|
|
* Before editing, creating, refactoring, or reviewing any file under `xllm/`, you **MUST** read [custom-code-style.md](.agents/skills/code-review/references/custom-code-style.md).
|
|
* The file above is a **required instruction file**, not an optional reference. Do not skip reading it.
|
|
* Apply the rules in [custom-code-style.md](.agents/skills/code-review/references/custom-code-style.md) to **both code generation and code review**.
|
|
* Follow DDD (Domain Driven Design) principles, and keep the codebase clean and maintainable.
|
|
* If [custom-code-style.md](.agents/skills/code-review/references/custom-code-style.md) specifies a rule, that rule takes precedence over the Google C++/Python Style Guide.
|
|
* Use the Google C++/Python Style Guide only for cases not specified in [custom-code-style.md](.agents/skills/code-review/references/custom-code-style.md).
|
|
|
|
## Review Instructions
|
|
|
|
* For code review tasks, you **MUST** first read [code-review/SKILL.md](.agents/skills/code-review/SKILL.md).
|
|
* Then read [custom-code-style.md](.agents/skills/code-review/references/custom-code-style.md) and apply it during the review.
|
|
* Review code changes for quality, security, performance, correctness, and maintainability following the project-specific standards.
|
|
* Review code changes for DDD (Domain Driven Design) principles, and keep the codebase clean and maintainable.
|
|
* Use the review workflow, checklist, severity rules, and output format defined in [code-review/SKILL.md](.agents/skills/code-review/SKILL.md).
|
|
* Apply the Google C++/Python Style Guide only when the project-specific style guide does not define the rule.
|
|
* Focus the review on the requested diff or changed files. Do not comment on unrelated code. |