ROCm/rocm-systems

amdsmi-changelog-automation

Check and generate changelog entries for amd-smi. Use when: reviewing PRs for changelog updates, generating release notes, checking CHANGELOG.md compliance.

Idioma del texto original: inglés

decode-and-triage

Decode and triage HRR capture archives with full GPU replay by default (Linux). Builds hrr-playback when missing. On Windows: full native GPU replay via triage_archive.ps1 + ensure_playback.ps1 (PowerShell); Docker replay requires Linux or WSL2. Never edits…

Idioma del texto original: inglés

pc-sampling

Profiles a target application using rocprofv3 with program counter sampling enabled and then analyzes the results. Use when the user has a program that runs on an AMD GPU and asks to perform PC sampling, to determine the runtime performance characteristics of…

Idioma del texto original: inglés

feature-unit-testing

Use when writing, planning, or improving unit tests for low-level transport or systems code — especially when reasoning about branch coverage, test gaps, identifying which uncovered paths are worth pursuing, or deciding when a feature's test suite is ready to…

Idioma del texto original: inglés

amdsmi-ci-logs

Use when a GitHub Actions run or job for an amd-smi / rocm-systems PR failed and the web UI shows truncated output, when you need the full failing log, or when you need CI artifacts (test reports, packages). Triggers: an actions/runs/<id>/job/<id> URL, 'where…

Idioma del texto original: inglés

amdsmi-test-runner

Run C++ and Python tests for amd-smi. Use when: running tests, verifying test results, checking test coverage, pre-review test validation.

Idioma del texto original: inglés

amdsmi-using-git-worktrees

Use when starting amd-smi feature work, executing an implementation plan, or reviewing a PR that needs an isolated workspace away from the main checkout. Sets up a worktree following the rocm-systems-pr<PR#> convention.

Idioma del texto original: inglés

amdsmi-improvement-evaluation

A structured approach to evaluating AMD SMI's current state and identifying improvement opportunities.

Idioma del texto original: inglés

amdsmi-commit-and-pr-conventions

Use when writing or restructuring git commits or opening/updating a pull request for amd-smi — composing commit titles, commit message bodies, PR titles, or PR descriptions. Defines the Conventional Commits `type(amdsmi):` title convention enforced by the…

Idioma del texto original: inglés

pressure-testing-skills

Use when validating or hardening a SKILL.md, prompt, rule, or any agent-followed document — when you need proof it actually works, not just that it reads well. Runs a fresh subagent that follows the doc literally on a known-answer fixture, captures friction,…

Idioma del texto original: inglés

writing-skills

Use when creating or editing a SKILL.md file under .claude/skills/. Defines the TDD-for-documentation discipline, structure, and CSO rules that every amd-smi skill must follow.

Idioma del texto original: inglés

perf-check

Run the rocDecode performance test and compare to baseline to catch regressions

Idioma del texto original: inglés

validate

Run full rocDecode build and test pipeline after code changes

Idioma del texto original: inglés

amdsmi-restructure-commits

Use when finishing an amd-smi development branch — consolidating commits into logical groups with clean messages AND deciding how to integrate the work (merge to develop, push and open PR, keep as-is, or discard). Covers commit restructuring plus the…

Idioma del texto original: inglés

writing-plans

Use when an approved spec exists and you need a bite-sized, file-level implementation plan before any code is written. Produces a plan ready for executing-plans or subagent dispatch.

Idioma del texto original: inglés

rdc-build-install

Build and install RDC from source. Use when: building locally, installing before tests, pre-review build verification, build + install + verify. Requires GRPC_ROOT to be set.

Idioma del texto original: inglés

amdsmi-agent-handoff

Use when handing work from one amd-smi agent to another (planning→development, planning→review, development→review) or compacting a long session into a fresh one. Produces a compact handoff doc referencing artifacts by path instead of duplicating them.

Idioma del texto original: inglés

amdsmi-interrogate

Use whenever amd-smi work begins from a design — a Confluence Feature Design, a Jira/SWDEV ticket, a driver hand-off, or a user description. Reconciles the design against what the code actually does, questions it adversarially, and produces an approved spec.…

Idioma del texto original: inglés

executing-plans

Use when a written implementation plan exists at ${TMPDIR:-/tmp}/amdsmi-agent-plans/ and you need to execute it task-by-task in the current session with verification at each step.

Idioma del texto original: inglés

test-driven-development

Use when implementing any amd-smi feature, bug fix, or behavior change — before writing implementation code. Enforces strict RED-GREEN-REFACTOR: failing test first, watch it fail, minimal code to pass, refactor.

Idioma del texto original: inglés

dispatching-parallel-agents

Use when facing 2+ independent problems with no shared state — e.g., unrelated test failures in different subsystems, multiple independent bug investigations, parallel research tasks. Dispatch one focused subagent per domain instead of investigating…

Idioma del texto original: inglés

systematic-debugging

Use when encountering any bug, test failure, build failure, or unexpected behavior in amd-smi — before proposing any fix. Enforces root-cause investigation before symptom patching.

Idioma del texto original: inglés

amdsmi-build-install

Build and install amd-smi from source. Use when: building locally, installing before tests, pre-review build verification, build + install + verify.

Idioma del texto original: inglés

amdsmi-packaging-test

Integration testing for amd-smi Python packaging. Use when: testing package installs, multi-OS testing, manylinux wheel builds, offline install verification, glibc/Python version compatibility, post-install smoke tests.

Idioma del texto original: inglés

amdsmi-output-verification

A checklist for verifying whether AMD SMI is reporting GPU information correctly.

Idioma del texto original: inglés

cuid-build-install

Build and install cuid from source. Use when: building locally, installing before tests, pre-review build verification, build + install + verify.

Idioma del texto original: inglés

populate-project-map

Creates or updates a human-readable project map for the cuid workspace. Use when onboarding, when workspace layout changes, or when agents need up-to-date layout info.

Idioma del texto original: inglés

amdsmi-python-style-guide

ROCm Python style guide based on TheRock. Use when: writing Python code, reviewing Python PRs, checking Python style, creating Python scripts, type hints, error handling patterns, pathlib usage, argparse CLI design.

Idioma del texto original: inglés

verification-before-completion

Verification checklist before marking work complete. Use when: finishing a fix, completing a review finding, validating a build, confirming a refactor.

Idioma del texto original: inglés