with one click
debug-kernel
// Debug compilation or runtime errors in LLK kernels. Infers architecture and kernel type from path.
// Debug compilation or runtime errors in LLK kernels. Infers architecture and kernel type from path.
Run LLK tests using the test runner agent. Never run pytest directly.
Look up Tensix architecture, instruction, or LLK implementation details across architectures. Orchestrates sage agents in parallel.
Get structured porting guidance when moving a kernel between architectures. Launches sages for source and target, reads test harness.
Enforce safe bash scripting practices when writing, reviewing, or fixing shell scripts. Covers quoting, arrays, conditionals, arithmetic, redirections, strict mode, and static analysis. Use when editing .sh/.bash files, reviewing shell scripts, fixing shellcheck warnings, or writing new bash code.
Guides test-first workflows for bugs and features: write a minimal failing test that encodes contracts and clear failure messages, confirm the gap is not already covered, implement and document the fix, then verify green. Use when fixing bugs with tests, adding features via TDD, writing regression tests, or when the user asks for red-green-refactor or test-driven development.
| name | debug-kernel |
| description | Debug compilation or runtime errors in LLK kernels. Infers architecture and kernel type from path. |
| user_invocable | true |
/debug-kernel tt_llk_blackhole/llk_lib/llk_pack_untilize.h
/debug-kernel tt_llk_quasar/common/inc/sfpu/ckernel_sfpu_gelu.h
/debug-kernel (no args — will ask for the kernel path or check recent test output)
common/inc/sfpu/ → sfpullk_lib/llk_math_ → mathllk_lib/llk_pack_ → packllk_lib/llk_unpack_ → unpacktt_llk_wormhole_b0/ → wormholett_llk_blackhole/ → blackholett_llk_quasar/ → quasarAgent tool:
subagent_type: "llk-debugger"
description: "Debug {kernel_name}"
prompt: |
Kernel path: {kernel_path}
Kernel type: {kernel_type}
Architecture: {architecture}
Error context: {any error output the user provided, or "check logs"}