# Omnibus Packaging Agent Guide

This file applies to `omnibus/` and overrides parent instructions where they differ.

## Scope

- Packaging definitions, software components, package scripts, and verification code.

## Safe Defaults

- Prefer read-only inspection and small edits.
- Do not run full package builds unless the user explicitly asks.
- Prefer targeted checks over full environment provisioning.

## Local Ruby Environment (RVM)

- For local development, run omnibus Ruby commands inside the active RVM project gemset.
- Prefer gemset-scoped `bundle install` and `bundle exec` usage over system-wide gems.

## Commands

- Install omnibus Ruby deps: `bundle install --binstubs`
- Build package (explicit request only): `bundle exec omnibus build cinc-workstation -l info \ --override
  append_timestamp:false`
- Clean temp build files: `bin/omnibus clean cinc-workstation`
- Purge clean is destructive: `bin/omnibus clean cinc-workstation --purge`

## Guardrails

- Keep project name as `cinc-workstation` in this repository unless the user requests upstream-sync changes.
- Avoid committing transient cache-path lines appended to `omnibus.rb` by local build scripts.
- Treat `pkg/` as generated output.
- Preserve package script behavior in `package-scripts/cinc-workstation/` unless a change is explicitly requested.

## Validation Expectations

- For small Ruby changes, prefer lint/style or narrow verification over full build.
- For packaging logic changes, explain what was not executed if the full omnibus build was skipped.

## References

- Packaging docs: `omnibus/README.md`
- Project-level guidance: `../AGENTS.md`
