Skip to content

LiorCohen/sdd / plugin/core/skills/orchestrators/version-orchestration

version-orchestration

Verified

Displays installed and project plugin versions with mismatch detection.

FileKindSize
SKILL.mdskill md2.2 KB
---
name: version-orchestration
description: Displays installed and project plugin versions with mismatch detection.
user-invocable: false
---

# Version Orchestration

Display the installed SDD plugin version and the project's plugin version, highlighting when the project is outdated.

## Input

Invoked by `sdd-run.md` with no arguments.

## Preconditions

- Plugin is loaded (agent has access to plugin root path)

## Flow

1. Read the installed plugin version from `<plugin-root>/.claude-plugin/plugin.json` → `version` field
2. Check if `sdd/sdd-settings.yaml` exists in the current directory
3. If it exists, read the project plugin version from `sdd.updated_by_plugin_version` (with fallback to legacy `sdd.plugin_version` for pre-reconciliation files)
4. Optionally read `sdd.initialized_by_plugin_version` for context (the version that first created the project)
5. Compare versions using semver:
   - **Match** — installed and project versions are the same
   - **Project outdated** — project version is older than installed version (the common case after a plugin upgrade)
   - **Project newer** — project version is newer than installed (unusual — may indicate a downgraded plugin)
6. Display the version report

## Output Scenarios

### When versions match

```
SDD Plugin

  Installed:       6.5.0
  Project:         6.5.0  ✓ match
  Originally from: 6.2.0
```

### When project is outdated (installed is newer)

```
SDD Plugin

  Installed:       6.5.0
  Project:         6.2.0  ⚠ outdated
  Originally from: 6.0.0

The project settings were last reconciled with an older plugin version.
  /sdd I want to initialize a new project
```

### When project is newer than installed (unusual)

```
SDD Plugin

  Installed:       6.3.0
  Project:         6.5.0  ⚠ installed plugin is older than project
  Originally from: 6.0.0

The installed plugin is older than what this project expects.
Run: claude plugins update sdd
```

### When not inside an SDD project

```
SDD Plugin

  Installed:  6.5.0
  Project:    (no SDD project detected)

NEXT STEPS:
  /sdd I want to initialize a new project
```

## Related

- `project-settings` skill - Owns the `sdd-settings.yaml` schema

## Output

Returns the version report as formatted text.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall