Skip to content

State the roofline target in the benchmark-kernel skill - #401

Merged
demandal25 merged 2 commits into
amd-integrationfrom
roofline-skill-rule
Nov 12, 2026
Merged

demandal25 merged 2 commits into
amd-integrationfrom
roofline-skill-rule

Conversation

@demandal25

Copy link
Copy Markdown
Collaborator

Summary

States the performance target for kernel work in the benchmark-kernel skill: every result is reported as %-of-roofline on each arch, and gfx942 and gfx950 are optimised separately wherever their hardware differs. A speedup alone does not say how much headroom is left.

What changed

  • .claude/skills/benchmark-kernel/SKILL.md — new "The target is the roofline, per arch" section:
    • Use the ceiling for the kernel's dtype and board. rocm_profiler's KNOWN_HW holds only the fp16 matrix peak and HBM bandwidth of one SKU per arch (MI300X, MI350X), so fp8/MX need scaling and MI325X/MI355X need their own peaks.
    • Optimise per arch where the hardware differs (LDS 64 vs 160 KB, 304 vs 256 CUs, fnuz vs OCP fp8, gfx950-only scaled MFMA and transposing LDS reads). Backend choice goes in arch_caps.py; tile and launch choices go in the kernel's own arch dispatch.
    • Stop only near the ceiling, or once the remaining gap has a named cause.

Benchmark results

Not applicable: documentation only.

Test plan

  • No code touched, so no tests apply
  • pre-commit run --from-ref origin/amd-integration --to-ref HEAD

Every result reports %-of-roofline per arch against the ceiling for the
kernel's dtype and board. rocm_profiler's KNOWN_HW holds only the fp16 peak
and HBM bandwidth of one SKU per arch, so fp8 and MX formats need scaling, and
MI325X and MI355X need their own peaks.

gfx942 and gfx950 are optimised separately where the hardware differs: the
backend choice goes in arch_caps, and tile and launch choices go in the
kernel's own arch dispatch.

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings November 12, 2026 04:20
@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Security scan found no critical or high findings on lines changed by this pull request

View the security scan run for complete reports.

“New” means the finding is located in a changed file on an added or modified line; it is not a base-versus-head findings delta.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues are recorded for the documentation-only update to roofline reporting and per-architecture tuning guidance.

No open issues 🎉

What changed in this PR

This documentation-only PR defines per-architecture roofline targets for kernel optimization in the benchmark skill.

Changes:

  • Requires results as a percentage of the roofline, using dtype- and board-specific ceilings.
  • Directs separate gfx942 and gfx950 optimization where hardware differs, with backend selection and kernel tuning handled in their respective locations.
  • Defines completion as approaching the ceiling or identifying the cause of the remaining gap.
File Description
.claude/​skills/​benchmark-kernel/​SKILL.md Adds roofline reporting requirements, per-architecture tuning guidance, and a stopping criterion.

Review effort: Balanced

Copilot AI balanced review requested due to automatic review settings November 12, 2026 04:25

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues are reported for the documentation-only update to ROCm roofline targets and reporting guidance.

No open issues 🎉

Review effort: Balanced

@demandal25
demandal25 merged commit 9c078ef into amd-integration Nov 12, 2026
13 checks passed
@demandal25
demandal25 deleted the roofline-skill-rule branch November 12, 2026 04:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants