| name | sounio-codegen-backends |
| description | Work on Sounio code generation and backends (Cranelift, LLVM, GPU, native ELF backend); use when editing `compiler/src/codegen/`, `compiler/src/backend/`, or backend-adjacent runtime glue. |
Sounio Codegen + Backends
Overview
Implement and debug lowering/codegen without breaking IR invariants or backend feature-flag boundaries.
Workflow
1) Pick the backend path and feature flags
- Cranelift:
compiler/src/codegen/cranelift.rs (feature: jit)
- MIR→Cranelift:
compiler/src/codegen/mir_cranelift.rs
- LLVM:
compiler/src/codegen/llvm/ (feature: llvm)
- GPU:
compiler/src/codegen/gpu/ (feature: gpu)
- Native backend (ELF/linker):
compiler/src/backend/native/
2) Keep IR invariants explicit
- If you change HLIR/MIR shape, validate passes and analyses that assume SSA form.
- Be conservative around effectful ops when doing backend optimizations.
3) Add targeted tests
- Prefer Rust tests close to the backend (
compiler/src/**/tests and compiler/tests/).
- GPU tests typically require
--features gpu (see .claude/commands/sounio-gpu.md).
References
- Codegen map:
references/codegen-navigation.md
- Feature flags:
references/feature-flags.md
- Claude command references:
.claude/commands/sounio-gpu.md, .claude/commands/sounio-build.md
