Skip to content

index.md

Latest commit

 

History

History
53 lines (46 loc) · 5.26 KB

index.md

File metadata and controls

53 lines (46 loc) · 5.26 KB
Raw
name index
description Lazy-load manifest for Bluefin Server skills. Load this file after AGENTS.md, then read only the skill that matches your current task.
metadata
type status last_updated
index
stable
2026-10-01

docs/skills — Index

This is the lazy-load routing table for agent skills. Keep this file in memory while you work; load only the skill file named in each row.

Loading contract

  1. Read AGENTS.md first.
  2. Consult CONTEXT.md for canonical project domain terminology (OS DDI, Installer, Netboot UKI, Disk UKI, Slot, Sysext, Transfer).
  3. Read this file.
  4. Read one skill file from the table below that matches the current task.
  5. Do not load unrelated skills. If a skill references another file, follow the link only when the referenced topic is part of the current task.

Routing table

Skill file When to load One-line scope
avoid-over-engineering.md Cutting scope, deleting code, resisting bloat Rules and red flags for keeping solutions small.
architecture-roadmap.md Future architecture direction, long-lead design Roadmap for systemd-native architecture work.
booty-integration.md HTTP boot, iPXE chainloading, per-node Ignition, kubeadm worker provisioning via Booty How the Booty network boot server serves releases to nodes.
bump-fsdk-version.md Pinning or retagging the FSDK junction Update the pinned FSDK release and derived tags.
ci-tooling.md GitHub Actions, workflow SHA pinning, CI conventions CI conventions and release pipeline rules.
ddi-installer-build.md Building and dogfooding the image set Local build, export, and QEMU dogfood workflow.
ddi-installer.md Boot flow, diskless pull, systemd-sysinstall, A/B sysupdate Boot, install, and update architecture.
diskless-troubleshooting.md Diskless node reboot-loops, RAM sizing, keeping logs, writing Ignition configs Failure summary, minimum RAM, failure modes, logs, supported Ignition subset.
factory-integration.md Lab integration, boot-test workflow, factory role How Bluefin Server is consumed by the CI lab.
gap-analysis-distros.md Comparing Bluefin Server to other server OSes Source-verified comparison to Ubuntu, Talos, Flatcar, FCOS.
homelab-profile.md The homelab Ignition templates, how they pull in the sysexts, the USB installer's Homelab entries Templates per runtime and role, what they turn on, publication, QEMU checks.
kubeadm-sysext.md Joining a kubeadm cluster, single-node kubeadm control plane, kubelet/containerd sysext, Kubernetes kernel options Build and runtime contract for the kubeadm sysext (worker or single-node control plane).
k0s-sysext-ops.md Operating k0s on Bluefin Server Runtime operation and troubleshooting for the k0s sysext.
k0s-sysext.md Building the k0s sysext BuildStream element and publish steps for the k0s sysext.
nvidia-sysext.md Adding, bumping, or debugging an NVIDIA driver (open kernel modules) or Container Toolkit (CDI) sysext Flavours and adding one, open-modules-only (Turing+) policy, driver and toolkit bumps, CDI and GPU Operator values.
secure-boot-keys.md Rotating signing keys, setting up CI secrets, debugging signature verification Key inventory, gen-dev-keys, CI secrets, and rotation.
skill-improvement.md Adding, splitting, or refactoring skills Meta-skill that owns the documentation loop.
system-containers.md Running systemd-nspawn toolboxes System container operation with machinectl.
systemd-sysext-extensions.md Optional layers via systemd-sysext / systemd-confext Extension identity, loading, and version matching.
systemd-sysupdate-verification.md Image-based A/B updates and signed manifests Release signing, systemd-sysupdate, and trust model.
tpm2-credential-sealing.md First-boot credentials, root/SSH node access, TPM2 sealing Provisioning credentials, node access, and sealing with systemd-creds.
usb-installer.md The offline USB installer image, unattended installs, install-time provisioning bluefin-server-installer_<ver>.raw boot flow, sysinstall drop-in, ESP credentials.

Standing facts

  • Publish registry: factory OCI registry at <registry-host>:30500 (or configured by operator).
  • Cluster build workflow: bluefin-server-build-pipeline in the downstream factory CI repository.
  • Cluster boot-test workflow: bluefin-server-boot-test in the downstream factory CI repository.
  • Version scheme: two axes — image-version (per build, include/image.yml, set by just set-version; CI uses YY.MM.<run> on main and 0.<run> on PRs) and installer-version (project.conf, tracking only the pinned FSDK point release).