projectbluefin

projectbluefin/website

Skill Claude CodeCodex

Use only for explicitly approved Wolves overlay, transport, player, or runtime engineering.

projectbluefin/website

Skill Claude CodeCodex

Use when changing the /wolves/ teaser hero, Trailer 1 player, the delivered-render embed, poster, ended URL card, or trailer fidelity tests.

projectbluefin/lab

Instructions file GitHub Copilot

Copilot instructions for projectbluefin/lab: Use ../AGENTS.md for repo policy and architecture, and use ../docs/agent-cheatsheet.md for the canonical command reference.

projectbluefin/lab

Instructions file CodexOpenCode

AGENTS.md instructions for projectbluefin/lab, covering lab — agent entry point, start here, what this repo is, build / test / lint and dashboard build check (when changing src/).

projectbluefin/lab

Skill Claude CodeCodex

Agent entry point for projectbluefin/lab. Find the skill that matches your task, load only that skill, then act.

projectbluefin/lab

Agent

Issues and PRDs for this repo live as GitHub issues. Use the gh CLI for all operations.

projectbluefin/lab

Agent

The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.

projectbluefin/lab

Skill Claude CodeCodex

One-sentence trigger: what area this skill covers and when an agent should load it. Keep under 50 words.

projectbluefin/lab

Skill Claude CodeCodex

Authoring, linting, and submitting Argo Workflows and WorkflowTemplates in the lab. Use when writing or editing any .yaml file under argo/workflow-templates/, argo/bootstrap/, or argo/.yaml, or when debugging a failed workflow run.

projectbluefin/lab

Skill Claude CodeCodex

Building or revising Astro dashboard detail pages backed by repo-tracked JSON and browser-side charts. Use when adding docs routes like /tests, /images, or /applications that must render real evidence, explicit unavailable states, GitHub Pages-safe static output, and dense table sections without crushed columns.

projectbluefin/lab

Skill Claude CodeCodex

Build, verify, and maintain the FSDK-based bluefin-server bootc image, including compilation elements, offline Cargo setups, and containerDisk conversion. Use when modifying server-image configs, troubleshooting sandboxed BuildStream builds, or resolving bootc target installation requirements.

projectbluefin/lab

Skill Claude CodeCodex

GitHub Actions workflow authoring and debugging for lab dashboards and automation. Use when changing .github/workflows/, troubleshooting stale Pages data, or wiring CI jobs that need private-cluster data.

projectbluefin/lab

Skill Claude CodeCodex

Cluster management tools for the lab: kubectl, k3s, zot, external-secrets, and K8sGPT. Use when managing cluster state, installing cluster add-ons, configuring the OCI registry, or running cluster analysis through MCP.

projectbluefin/lab

Skill Claude CodeCodex

KubeStellar Console operations: deploy/upgrade via ArgoCD, auth and exposure policy, marketplace cards, guided missions, and the GitOps vs imperative action split. Use when working on the Console deployment or wiring dashboard surfaces.

projectbluefin/lab

Skill Claude CodeCodex

Review Dakota pull requests through the lab-backed workflow: dispatch the Dakota QA run, keep maintainer decisions tied to fresh evidence, and hand off a clear operator summary. Use when a Dakota PR needs lab validation or triage.

projectbluefin/lab

Skill Claude CodeCodex

Add a Flatcar Linux node to the k3s cluster and connect it to the Nebraska kernel update pipeline. Use when onboarding a new Flatcar node (e.g. exo-0, exo-2), joining it to k3s, or pointing updateengine at the local Nebraska server. Covers k3s sysext install, DaemonSet auto-configuration, and validating the update…

projectbluefin/lab

Skill Claude CodeCodex

Design direction for the Project Bluefin factory dashboard website. Use whenever modifying Astro pages, CSS, charts, or visual components under src/. Enforces deliberate, subject-grounded choices over templated dashboard defaults.

projectbluefin/lab

Skill Claude CodeCodex

ArgoCD GitOps model for the lab: what is and isn't managed, sync rules, bootstrap vs managed distinction, and common sync failures. Use when working with ArgoCD Applications, adding new templates to git, or troubleshooting sync issues.

projectbluefin/lab

Skill Claude CodeCodex

KubeStellar multi-cluster control plane on the lab: WDS/ITS/WEC model, install/upgrade via ArgoCD, WEC registration, BindingPolicy authoring, smoke testing, and failure modes. Use when working with KubeStellar, KubeFlex control planes, OCM ManagedClusters, or BindingPolicies.

projectbluefin/lab

Skill Claude CodeCodex

KubeVirt ephemeral VM lifecycle in the lab: containerDisk build, VM provisioning, SSH wait, teardown. Use when writing provision-vm templates, debugging VM boot failures, or working with KubeVirt manifests.

projectbluefin/lab

Skill Claude CodeCodex

Self-learning and skill-maintenance loop for the lab. Run at the end of every session that produces non-trivial work, and at the start of any session to check unanalyzed nightly failures. Enforces the write-back loop so the next agent starts smarter than this one did. Use when wrapping up any session, before creating…

projectbluefin/lab

Skill Claude CodeCodex

Add, drain, and remove capacity in the Bluefin Server home cluster: k3s node join (shared-cluster expansion), WEC cluster join, and the elastic BuildStream grid checks. Agent-executable counterpart of the GUI onboarding flow. Use when adding a second PC, removing a node, or verifying builds scale with new capacity.

projectbluefin/lab

Skill Claude CodeCodex

Working with the transparent registry catalog feature: the linuxserver.io catalog index, deploy-time install translation, validation, GitOps PR flow, and adding future providers (NGC/AMD/DockerHub). Use when editing docs/data/catalog/, scripts/collectlsiocatalog.py, scripts/cataloginstalllsio.py…

projectbluefin/lab

Skill Claude CodeCodex

Writing, debugging, and running behave/qecore/dogtail GNOME GUI tests. All Bluefin image tests live in projectbluefin/testsuite. Use when adding test scenarios, fixing AT-SPI failures, debugging Shell.Eval interactions, or working with the qecore-headless session.