Need
Bootstrapping the OpsMill spec-kit stack in a consumer repo currently means running
six independent install commands, in the right order, from three different sources:
specify extension add opsmill (this repo)
specify extension add review (ismaelJimenez/spec-kit-review)
specify extension add critique (arunt14/spec-kit-critique)
specify extension add reconcile (stn1slv/spec-kit-reconcile)
specify preset add taskstoissues-jira (this repo)
specify preset add --dev …/presets/reconcile-opsmill (this repo, needs a git clone)
Nothing ties those six together. There is no single artifact that says "this is the
OpsMill stack", and no statement of which combination of versions has been validated
together — the extension is at 1.2.0, the presets are versioned independently, and
release history is split across two changelogs. Order matters (reconcile-opsmill is
inert unless the reconcile extension is already installed), but that only lives in
README prose, and a partial or out-of-order install fails quietly: the preset lands,
the command it overrides never appears.
This affects anyone standing up a new repo on the house workflow, and it costs us
maintenance — install instructions are duplicated across the root README and two
preset READMEs, and each new preset adds another step to keep in sync.
Spec-kit's bundle primitive looks like the right shape for this: a curated,
versioned, installable unit composing extensions and presets, installed in one step.
Notably it would cover the presets too, which today are strictly bolted on afterwards.
We should investigate what it would take to ship the OpsMill stack as a bundle, and
confirm it actually delivers the one-step install we want before committing to it.
Context
- What this repo ships today: the
opsmill extension (extension.yml, 7 commands,
1 opt-in hook) plus two presets (presets/taskstoissues-jira,
presets/reconcile-opsmill), each with its own preset.yml and README.
- Three third-party extensions are hard dependencies of the current surface:
critique and review (used by prep / auto / implement) and reconcile
(whose command the reconcile-opsmill preset overrides).
- Licensing is not uniform across the components — the extension and
taskstoissues-jira are Apache-2.0, reconcile-opsmill is MIT (it carries its own
LICENSE, being derived from an MIT upstream extension).
- Worth settling as part of the investigation: whether the individual extension and
preset install paths stay supported alongside a bundle, or the bundle becomes the
only documented entry point.
- Bundle support is new upstream, so the investigation should start from the current
state of the reference and the spec-kit release we'd be targeting.
References
Need
Bootstrapping the OpsMill spec-kit stack in a consumer repo currently means running
six independent install commands, in the right order, from three different sources:
specify extension add opsmill(this repo)specify extension add review(ismaelJimenez/spec-kit-review)specify extension add critique(arunt14/spec-kit-critique)specify extension add reconcile(stn1slv/spec-kit-reconcile)specify preset add taskstoissues-jira(this repo)specify preset add --dev …/presets/reconcile-opsmill(this repo, needs agit clone)Nothing ties those six together. There is no single artifact that says "this is the
OpsMill stack", and no statement of which combination of versions has been validated
together — the extension is at
1.2.0, the presets are versioned independently, andrelease history is split across two changelogs. Order matters (
reconcile-opsmillisinert unless the
reconcileextension is already installed), but that only lives inREADME prose, and a partial or out-of-order install fails quietly: the preset lands,
the command it overrides never appears.
This affects anyone standing up a new repo on the house workflow, and it costs us
maintenance — install instructions are duplicated across the root README and two
preset READMEs, and each new preset adds another step to keep in sync.
Spec-kit's bundle primitive looks like the right shape for this: a curated,
versioned, installable unit composing extensions and presets, installed in one step.
Notably it would cover the presets too, which today are strictly bolted on afterwards.
We should investigate what it would take to ship the OpsMill stack as a bundle, and
confirm it actually delivers the one-step install we want before committing to it.
Context
opsmillextension (extension.yml, 7 commands,1 opt-in hook) plus two presets (
presets/taskstoissues-jira,presets/reconcile-opsmill), each with its ownpreset.ymland README.critiqueandreview(used byprep/auto/implement) andreconcile(whose command the
reconcile-opsmillpreset overrides).taskstoissues-jiraare Apache-2.0,reconcile-opsmillis MIT (it carries its ownLICENSE, being derived from an MIT upstream extension).preset install paths stay supported alongside a bundle, or the bundle becomes the
only documented entry point.
state of the reference and the spec-kit release we'd be targeting.
References
README.md(§ Install, § Companion extensions),presets/taskstoissues-jira/README.md,presets/reconcile-opsmill/README.mdextension.yml,presets/*/preset.yml