building-with-muse

Guide Mu2e software builds with Muse, Spack, and SCons.

4|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/Mu2e/aitools --skill building-with-muse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building-with-muse
Source: https://github.com/Mu2e/aitools/tree/main/skills/building-with-muse
Command: npx skills add https://github.com/Mu2e/aitools --skill building-with-muse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and commands for navigating and utilizing the Muse build system, essential for developing and managing Mu2e software projects.

Core Features & Use Cases

  • Build Orchestration: Understand and execute builds for Mu2e software using Muse and SCons.
  • Environment Management: Configure build environments, manage dependencies via Spack, and set up build configurations (production/debug).
  • Use Case: When you need to compile your custom analysis code against the official Mu2e Offline release, this Skill guides you through setting up the correct environment and performing the build.

Quick Start

Use the building-with-muse skill to set up the production build environment for your work directory.

Frequently Asked Questions about building-with-muse

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

FAQPage Schema
How do I build Mu2e Offline analysis code against an official release?

To build Mu2e Offline analysis code, you must configure the build environment using Muse and SCons, managing dependencies via Spack to compile your custom work directory against the official release.

How does Muse handle Spack dependency management for local software development?

Muse orchestrates Spack dependency management by configuring the build environment, ensuring all required packages are resolved and available for incremental local software builds and environment setup.

Can I create tarballs for grid job submission using the Muse build system?

Yes, the Muse build system facilitates tarball creation for grid job submission, allowing you to package compiled software components and dependencies for deployment to grid computing environments.

How do I configure production and debug build environments with Muse?

You can configure production and debug build environments in Muse by setting up specific build configurations, orchestrating SCons to compile Mu2e software with the appropriate environment variables and dependency settings.

What are custom envsets and how do I manage link order in Muse?

Custom envsets in Muse allow tailored environment configurations for specific build requirements, while link order management ensures correct dependency resolution and compilation order for complex Mu2e software projects.

Why should I use Muse over standard SCons for Mu2e software builds?

Muse extends standard SCons by providing specialized build orchestration for Mu2e software, integrating Spack dependency management, environment configuration, and grid tarball creation into a unified build system workflow.