packages

name	packages
version	1.0
last_updated	2026-08-06T00:00:00.000Z
id	packages
one_line_purpose	Add, remove, or classify RPM, Flatpak, COPR, and Homebrew inputs.
entry_point	docs/skills/packages/SKILL.md
category	ci-ops
mcp_compliance_level	partial
optimization_status	draft
status	active
dependencies	[]
tags	["packages","rpm","flatpak","copr","homebrew"]
description	Provides the decision tree for where a package belongs and the files that declare each package source. Use when adding, removing, or relocating a package input.
metadata	{"type":"procedure","source-of-truth":["build_files/packages/","build_files/base/03-packages.sh","build_files/shared/copr-helpers.sh","flatpaks/","brew/"]}

Packages

Decision tree

Need	Preferred location
GUI application	Flatpak
CLI or user tool	Homebrew
Required system dependency	Fedora RPM
Third-party RPM	Isolated COPR
Legacy application	External user-space environment

Procedure

1. Search the repository and shared inputs before adding a new source.
2. Put base package data in the package manifest, not an inline shell array.
3. Keep Fedora and COPR package transactions separate.
4. For images installed with bootc install, include bootupd explicitly; do not rely on the base image to provide it transitively.
5. Run:

just check
pre-commit run --all-files

For shell changes:

bash -n build_files/base/03-packages.sh
shellcheck build_files/**/*.sh

Security boundary

COPR installs must preserve the helper's enable → disable → explicit install sequence. See COPR isolation.

When to Use

Use for RPM, Flatpak, COPR, or Homebrew input changes.

When NOT to Use

Do not use for Generic build validation or release debugging.

Core Process

Classify the input, edit its source manifest, validate resolution and policy.

Common Rationalizations

• "A shortcut is harmless." Follow the source-of-truth and verification rules instead.

Red Flags

• Putting package data in the wrong layer or mixing trusted and third-party sources.

Verification

• The selected source and focused command were checked.
• The repository default gate passes.