projectbluefin/finpilot

finpilot-build

Containerfile multi-stage build, image digest pinning in FROM lines, Justfile local build recipes, and build script conventions. Use when changing Containerfile, Justfile, or build/*.sh.

finpilot-onboarding

Fork bootstrap playbook: rename (locations: `finpilot-templates`), enable Actions, RENOVATE_TOKEN, first green build, README "What Makes this Raptor Different" section, and branch protection. Use when creating a new fork from this template.

finpilot-pr-checklist

PR gates and pre-commit checklist by change type. Covers validation commands for Containerfile, build scripts, Brewfiles, Flatpaks, ujust, workflows, and README changes. Use before opening or reviewing a PR.

finpilot-router

Task router for the finpilot repo: which skill covers what, and the overview → domain → PR-checklist sequence. Use when unsure which skill fits, or to add a skill to the routing table.

finpilot-ci

GitHub Actions workflows, projectbluefin/actions composite actions, Renovate configuration, and PR validation for finpilot. Use when changing .github/workflows/, .github/renovate.json, or .hadolint.yaml.

finpilot-maintain

Maintenance of an active finpilot fork: Renovate digest PRs, README raptor section updates, signing verification, local test loops, and maintenance schedules. Use when maintaining a fork after onboarding.

finpilot-templates

Template identity rules: the seven rename locations, image identity ARGs, keyless signing, and AGENTS.md update rules. Use when renaming a fork, verifying or explaining signing, or updating AGENTS.md and setup docs.

finpilot-troubleshooting

Consolidated symptom-cause-fix table for finpilot. Covers local build failures, CI failures, runtime issues, Renovate problems, COPR persistence, and ujust command not found. Use when something is broken and you need a quick diagnosis.

finpilot-overview

Architecture, repo layout, and factory role for the finpilot template. Use when orienting to the repository, understanding how it relates to projectbluefin/actions, or before picking a skill with finpilot-router.

skill-improvement

Record durable finpilot-specific learning after discovering a command, convention, workaround, or failure mode.

finpilot-custom

Runtime layer of finpilot: Brewfiles, Flatpaks, and ujust commands — syntax, placement, and validation. Use when modifying custom/ or explaining the runtime layer to contributors.

finpilot-examples

Index of runnable example scripts and the activation pattern. Covers existing .example files and how to activate them. Use when adding new build scripts or explaining the activation pattern to contributors.

finpilot-packages

Decision tree for where to add packages in finpilot. Maps requests to the correct file and install method: build-time dnf5, runtime Brewfile, or runtime Flatpak. Use when deciding how to add a new package or tool.