update-aipcc-base-images-overlay

name	update-aipcc-base-images-overlay
description	Use when the AIPCC base image repository has changed and the overlay file overlays/0017-aipcc-base-images.md needs to be refreshed with current accelerator support information, versions, or architecture details.
user-invocable	true
allowed-tools	Read, Write, Bash(bash ${CLAUDE_SKILL_DIR}/scripts/fetch-base-images-repo.sh), Bash(./tmp/app/bin/generate-platform-docs.py), Glob, Grep

Update AIPCC Base Images Overlay

Refresh overlays/0017-aipcc-base-images.md with current information from the AIPCC base images repository.

Overview

The overlay documents the accelerator variants (CPU, CUDA, ROCm, Gaudi, Spyre, Neuron, TPU) built from the base-images/app repository. It is used to evaluate RFEs that propose changes to accelerator support. When the repository changes, run this skill to update the overlay.

Instructions

Step 1: Clone or Update the Repository

Run the fetch script from the root of the architecture-context repository:

bash ${CLAUDE_SKILL_DIR}/scripts/fetch-base-images-repo.sh

This clones https://gitlab.com/redhat/rhel-ai/core/base-images/app.git to ./tmp/app, or pulls the latest changes if the clone already exists.

Step 2: Generate Tables from the Repository

Run the repository's own documentation generator as an executable:

./tmp/app/bin/generate-platform-docs.py

Capture the full output — it contains the accelerator summary table and per-variant details that form the factual base of the overlay.

If the script produces output files rather than printing to stdout, read those files to get the generated content.

Step 3: Read the Current Overlay

Read the current content of overlays/0017-aipcc-base-images.md to understand the existing structure, especially the "Impact on Strategies" and "Context" sections, which contain human-authored guidance that must be preserved and updated — not replaced wholesale.

Step 4: Update the Overlay

Rewrite overlays/0017-aipcc-base-images.md using the following approach:

Preserve the YAML front matter (id, title, status, created, affects, release, provenance, author, superseded_by). Update release only if the repository clearly targets a new RHEL AI release.

Fact section — Replace entirely with fresh content derived from the generator output and the repository. This section must describe:

• What the base images are and how downstream teams use them
• The common foundation (base OS, Python version, RHEL AI repo version, package index version, repositories, container layout, environment metadata, helper script)
• An Accelerator Summary table with columns: Accelerator | Version | Status | Python | RHEL | aarch64 | ppc64le | s390x | x86_64
• A Status Legend explaining Active / In development / Disabled / Retired
• One subsection per accelerator variant (CPU, NVIDIA CUDA variants, AMD ROCm, Intel Gaudi, IBM Spyre, AWS Neuron, Google TPU) covering: status, config file, architectures, container image, driver requirements (if applicable), and key dependencies
• A Retired Accelerators subsection for anything removed from the repo

Impact on Strategies section — Update to reflect the current state of each accelerator variant. The section must include at least:

• A bullet noting that all RHAI components using accelerator-specific Python libraries must use these base images
• Bullets for each non-Active variant (in-development, disabled, retired) explaining what strategies must or must not assume
• A bullet about the number of concurrent CUDA versions and the driver-version dependency each introduces
• A bullet about any per-architecture versioning schemes (e.g., IBM Spyre)
• A bullet about the authoritative Python package index

Context section — Keep largely as-is but update the date and any version references so it remains accurate. The context explains why the overlay exists; that rationale does not change with routine updates.

Step 5: Write the Updated File

Write the updated content to overlays/0017-aipcc-base-images.md using the Write tool.

Step 6: Report

Output a brief summary:

Updated overlays/0017-aipcc-base-images.md

Changes:
- [list any accelerators added, removed, or with changed status/versions]
- [note any changes to common foundation]

Repository cloned/updated: tmp/app (not tracked by git)

Notes

• Trust assumption: This skill executes generate-platform-docs.py from https://gitlab.com/redhat/rhel-ai/core/base-images/app.git without integrity verification. The upstream repository is assumed to be trusted and not compromised. Do not run this skill against a fork or unofficial mirror.
• tmp/ is in .gitignore; the cloned repository is local only
• The script is idempotent: run it again any time the upstream repository changes
• Do not change the overlay id (0017) or author fields
• Preserve Jira ticket references (e.g., AIPCC-3471) in the Fact section when they are still accurate; remove them if the underlying issue is resolved