module-versioning

Sets an Intent Architect module version via Module Settings and propagates it to dependents.

23|10|Updated Aug 31, 2017
One-click install
npx skills add https://github.com/IntentArchitect/Intent.Modules --skill module-versioning-intentarchitect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: module-versioning
Source: https://github.com/IntentArchitect/Intent.Modules/tree/main/Tests/ModuleBuilderSkills/.opencode/skills/module-versioning
Command: npx skills add https://github.com/IntentArchitect/Intent.Modules --skill module-versioning-intentarchitect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting an Intent Architect module's version incorrectly—such as hand-editing the .imodspec file—causes the Software Factory to silently discard changes, and forgetting to propagate the new version leaves architecture templates and dependent modules out of sync. ## Core Features & Use Cases - Designer-Driven Versioning: Sets the version through the Module Builder designer's Module Settings → Version property so the Software Factory regenerates .imodspec correctly. - Downgrade Guard Handling: Explains the silent skip when a lower version is supplied and the one safe hand-edit procedure to clear it. - Dependent Propagation: Updates metadata.iatspec for architecture templates and <dependency> entries in dependent modules, plus NuGet .csproj alignment to avoid NU1605. - Use Case: You need to release module version 1.3.0: set it in the designer, run the Software Factory, confirm only the version line changed via get_file_diffs, then update dependents and run module-docs to sync release notes. ## Quick Start Set my module's version to 1.3.0 using the module-versioning skill and propagate it to all dependents.

Frequently Asked Questions about module-versioning

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

FAQPage Schema
How do I set an Intent Architect module version?▼

Set the version in the Module Builder designer via the Module Settings stereotype's Version property, then run the Software Factory to regenerate the .imodspec file. Confirm with get_file_diffs that only the version line changed.

Why is my .imodspec version change not applied?▼

The Software Factory only writes the version when the designer value sorts strictly higher than the one on disk; a lower value is skipped silently. Hand-edit the .imodspec version line down to a safe value, then set your target version in the designer and regenerate.

Can I hand-edit the .imodspec file directly?▼

Most of .imodspec is hand-authored by design, but six elements—including version, summary, description, iconUrl, id, and migrations—are owned by the Software Factory. Hand-editing those is silently discarded on the next run.

How do I propagate a module version to dependent modules?▼

Update the Component Module's Version in metadata.iatspec for architecture templates after confirming publication via search_available_modules, and update the dependency version attribute in other modules. Keep .csproj NuGet package versions aligned to avoid NU1605 errors.

When should I not use the module-versioning skill?▼

Do not use it to decide whether, when, or which component should receive a version bump—that decision belongs to the module-version-increment skill. This skill only executes a specific version string already supplied by the caller.