arrow_back Back to Catalog
workflows Beginner

Workflow /install

Install workflows/rules from the Governed Catalog into your workspace.

The /install command acts as an intelligent installer, allowing you to fetch standardized workflow or rule templates from the Governed Catalog and place them directly into your current project. It handles existing file conflicts gracefully.

Command List

/install work [name]   # Install a specific workflow (e.g., kickoff)
/install rule [name]   # Install a specific rule (e.g., branding)

Execution Steps

1. Source and Destination Resolution

The system automatically identifies the source file within the Catalog and maps it to the correct project directory (typically .agent/workflows/ or .agent/rules/).

2. Conflict Detection

  • Does not exist: Installs the latest version immediately.
  • Already exists: Compares Local vs. Catalog content. If identical, the Agent reports “Already up to date.”

3. Intelligent Conflict Resolution

When differences are detected, you have several options:

  • Overwrite [O]: Replace the Local version entirely with the Catalog version.
  • Merge [M]: Intelligently combine logic (Workflows only) - Triggers the /merge flow.
  • Rename [R]: Install as [name]-catalog so you can compare manually later.
  • Cancel [C]: Abort the installation.

Relationships

  • /merge — Merge workflow logic during upgrades.
  • /para-workflow — Global workflow management catalog.