CLAUDE.md

# LightOp Kernel Knowledge Schema

This directory supports `lightop-kernel-knowledge`.

Use evidence routes in this order:

- Route A: local LightOp source, bindings, wrappers, tests, benchmarks, and
  config tables.
- Route B: ROCm/DCU official docs and upstream source.
- Route C: bundled PR corpus, mostly CUDA/NVIDIA-oriented, as cross-platform
  inspiration only.
- Route D: external source-map repositories when relevant.

Do not treat CUDA profiler metrics, PTX/SASS, CUTLASS/CuTe, TMA, WGMMA, or
tcgen05 evidence as proof for DCU behavior. Translate ideas to HIP/DCU concepts
and validate with LightOp tests, benchmarks, and DCU profiling.

Useful local commands:

```bash
python3 scripts/query.py "<keywords>" --compact
python3 scripts/query.py "hygon dcu mmac" --type source-reference --compact
python3 scripts/query.py "amd knowledge base dcu" --type source-reference --compact
python3 scripts/search-pr-diffs.py <term1> <term2> [--any]
python3 scripts/get_page.py <page-id>
python3 scripts/validate.py
```