dakota-iso ā Copilot Instructions#
This repo builds the bootable UEFI live ISO from projectbluefin images (GNOME OS / bootc / composefs).
Active variants:dakota(NVIDIA-unified, daily at 03:00 UTC) andutah(build-iso-utah.yml, monthly from:stable, 04:00 UTC on the 8th).
bluefinandbluefin-lts-hweare retired (#228) ā matrix entries disabled. Do not re-add them to CI matrices; seedocs/variants.md.
Fast path#
1. AGENTS.md # repo operating contract ā read first
2. docs/SKILL.md # find the skill for your task
3. justfile # all build tasks go through here
Agentic model#
This repo is part of the projectbluefin factory.
Cross-repo hard rules, branch targets, and PR comment policy:
projectbluefin/common/docs/factory/agentic-model.md
Branch target: PRs go to main.
š« ublue-os absolute prohibition#
NEVER create issues, PRs, comments, or any programmatic write action targeting any ublue-os/* repository.
Read-only gh api calls are permitted. No writes of any kind.
Commit format#
Conventional Commits: <type>(<scope>): <description>
Every AI-authored commit must include both trailers:
Assisted-by: <Model> via GitHub Copilot
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sensitive paths#
Changes to these require maintainer review:
.github/workflows/ā CI pipelinejustfileā canonical build interfacelive/src/build-iso.shā ISO assemblylive/src/configure-live.shā live environment setupscripts/build-live-squashfs.shā squashfs + OCI embed
Pre-commit#
just check # run before every commit (agentic-model hard rule)
check runs the pytest suite plus the pre-commit hooks (yaml/json validation,
actionlint, action-pin policy) ā the same two gates CI enforces.
Human gates#
Stop and ask a human at:
- Design: architecture change, new subsystem, user-visible behavior change
- Security: signing, supply chain, secrets, third-party sources
- Breakage: cross-repo breaking change
- Merge: always requires human approval
See docs/skills/human-gates.md for evidence requirements.
Self-improvement loop#
Every session produces two outputs: the work and the learning.
Skill updates go in the same PR, never a follow-up.
See docs/skills/skill-improvement.md.
Use the shared label workflow
and Prow commands: humans triage with /triage accepted, review with /lgtm,
and approve with /approve. Never write to ublue-os/*.