managing-bst-overrides

Manage BuildStream junction element overrides with creation, removal, and audit criteria.

134|27|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/projectbluefin/dakota --skill managing-bst-overrides
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-bst-overrides
Source: https://github.com/projectbluefin/dakota/tree/main/.opencode/skills/managing-bst-overrides
Command: npx skills add https://github.com/projectbluefin/dakota --skill managing-bst-overrides

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides guidance on how to properly manage BuildStream junction element overrides, ensuring that Bluefin OS adheres to the upstream-first principle and maintains recognizable patterns for GNOME OS maintainers.

Core Features & Use Cases

  • Override Creation: Guides users on when and how to create local overrides for BuildStream elements, emphasizing justification for Bluefin-specific needs.
  • Override Removal: Provides a detailed checklist for safely removing unnecessary overrides, including verification and documentation steps.
  • Audit & Hygiene: Outlines a process for periodically auditing existing overrides to ensure they remain justified and to identify potential misuse.
  • Use Case: When a new version of a core component is released upstream, this skill helps determine if the change should be patched or if an override needs to be updated or removed.

Quick Start

Use the managing-bst-overrides skill to audit the current overrides in elements/gnome-build-meta.bst.

Frequently Asked Questions about managing-bst-overrides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage BuildStream junction overrides for GNOME OS?

Manage BuildStream junction overrides by defining strict criteria for their creation, removal, and auditing to ensure adherence to the upstream-first principle. Differentiate between justified branding needs and unnecessary patches to reduce maintenance burdens.

When should I create a BuildStream override instead of patching upstream?

Create a BuildStream override only when justified by Bluefin-specific branding needs or significant behavioral changes. Differentiate these necessary local overrides from unnecessary patches that create maintenance burdens and violate the upstream-first principle.

What is the best way to audit BuildStream elements for unnecessary overrides?

Audit BuildStream elements by periodically reviewing existing overrides to ensure they remain justified and identify potential misuse. This process outlines detailed steps for override lifecycle management and flags deviations from upstream-first development patterns.

How do I safely remove an override from a BuildStream project?

Remove an override from a BuildStream project by following a detailed checklist that includes verification and documentation steps. This ensures the safe removal of unnecessary overrides and maintains adherence to the upstream-first principle.

What are the red flags for BuildStream override misuse in GNOME OS development?

Red flags for BuildStream override misuse include creating unnecessary overrides that cause maintenance burdens and deviate from recognizable GNOME OS maintainer patterns. Identifying these deviations ensures adherence to the upstream-first principle.

Does managing BuildStream overrides require upstream-first principles?

Managing BuildStream overrides requires strict adherence to upstream-first principles to maintain recognizable patterns for GNOME OS maintainers. This approach ensures overrides serve justified branding or behavioral needs rather than creating unnecessary maintenance burdens.