projectbluefin/bluefin

ci

Explains workflow triggers, path filters, reusable workflow calls, and how to read failing runs in this repository. Use when a workflow failed, did not start, or ran the wrong checks.

security

States the package-source trust boundaries, signing requirements, and secure-boot constraints for this image. Use when adding a package source or changing verification or trust behavior.

release-artifacts

Covers the release and testing-to-main promotion workflows, digest and tag verification, and signing gates. Use when running a release or diagnosing a failed promotion.

issue-lifecycle

Explains issue assignment, project state, label semantics, and the branch- to-pull-request path used in this repository. Use when picking up, updating, or closing an issue.

dependency-automation

Describes the Renovate configuration, automerge workflow, and authentication model for automated updates. Use when changing dependency automation config or triaging an automated update pull request.

build

Covers Containerfile stages, build_files layering, local image builds, and which validation gate to run for a given change. Use when editing image inputs or deciding whether a full build is required.

installation-artifacts

Covers dispatching artifact workflows, confirming the source image digest, and promoting a verified artifact. Use when building or promoting an ISO or other installation artifact derived from a published image.

packages

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.

setup-hook-tests

Describes the Bats sandbox layout, path patching, and command stubbing used to test setup hooks in tests/unit. Use when adding or changing coverage for a system_files setup hook.

skill-improvement

Explains when to update an existing skill, how to avoid duplicating source-of-truth facts, and how to split oversized skills. Use when a reusable fact or procedure changes and a skill must follow.

variants

Maps image names, streams, flavors, and branches to their published tags and build workflows. Use when choosing an image reference for a command, report, or workflow dispatch.

worktrees

Covers the worktree helper script, branch naming, and cleanup so the main checkout stays clean. Use before starting any change, or when the main checkout is dirty or on a stale branch.

write-a-skill

Defines the required SKILL.md front-matter keys, size budget, index entry, and validation command for a new skill in this repository. Use when adding a new docs/skills directory or repairing front matter that fails validation.