opendatahub-io/architecture-context

aggregate-platform-architecture

Combine multiple component architecture summaries into a platform-level architecture document. Use after generating component summaries to create a wholistic platform view.

repo-to-architecture-summary

Analyze an ODH/RHOAI component repository and generate an evidence-backed architecture summary.

update-aipcc-base-images-overlay

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.

update-rhai-pipeline-overlay

Use when the rhai/pipeline repository has changed and the overlay file overlays/0020-rhai-pipeline.md needs to be refreshed with current product version, published variants, collection matrix, or Pulp publishing details.

update-rhaiis-pipeline-overlay

Use when the rhaiis/pipeline repository has changed and the overlay file overlays/0021-rhaiis-pipeline.md needs to be refreshed with current vLLM versions, variant matrix, or package content details.

update-wheels-builder-overlay

Use when the AIPCC wheels builder repository has changed and the overlay file overlays/0019-wheels-builder.md needs to be refreshed with current builder version, variant matrix, pipeline-API contract, or plugin system details.

discover-components

Discover platform components by exploring breadcrumbs (installers, operators, dependencies) in checkouts directory. Outputs component-map.json for platforms without manifest scripts.

generate-architecture-diagrams

Generate architecture diagrams (Mermaid, C4, security network diagrams) from GENERATED_ARCHITECTURE.md. Creates visual representations for different audiences - developers, architects, security teams.

generate-component-diagrams

Generate diagrams for all component architecture files in an organized architecture directory. Processes each component sequentially ONE AT A TIME by reading the .md file and extracting data from tables. Creates Mermaid, C4, and security diagrams. Skips…

generate-platform-diagrams

Generate platform-level diagrams (dependency graphs, network topology, cross-component workflows) from aggregated PLATFORM.md file. Creates visualizations for architects, security teams, and platform engineers.

analyze-platform-components

Analyze all components for a platform (ODH or RHOAI) sequentially by parsing get_all_manifests.sh and executing repo-to-architecture-summary for each. Skips components that already have GENERATED_ARCHITECTURE.md. Fully autonomous and resumable.

collect-component-architectures

Collect and organize GENERATED_ARCHITECTURE.md files from checkouts into a structured architecture directory by platform, version, and component name.

analyze-running-cluster

Validate architecture documentation against a running Kubernetes/OpenShift cluster. Compares expected architecture (from GENERATED_ARCHITECTURE.md) with actual deployed resources to find drift.