openspec-update-change

Revises existing OpenSpec change planning artifacts and keeps them coherent with each other.

1|Updated Aug 21, 2023
One-click install
npx skills add https://github.com/jmuchovej/homelab --skill openspec-update-change-jmuchovej
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-update-change
Source: https://github.com/jmuchovej/homelab/tree/main/.agents/skills/openspec-update-change
Command: npx skills add https://github.com/jmuchovej/homelab --skill openspec-update-change-jmuchovej

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a plan changes mid-stream, the artifacts describing an OpenSpec change (proposals, designs, specs, tasks) drift out of sync. This Skill revises an existing change's planning artifacts so they stay consistent with one another, without touching any implementation code. ## Core Features & Use Cases - Coherence Review: Reads all existing artifacts of a change and checks them against each other for contradictions, gaps, and duplication, in any direction. - Confirmed Revisions: Proposes each edit, explains why, and writes only after user confirmation, one artifact at a time. - Schema-Agnostic Operation: Uses artifact ids and paths reported by openspec status rather than hardcoded names, so custom schemas work unchanged. - Use Case: You decided the design now uses a message queue instead of direct calls. Run this Skill to update the design artifact and reconcile the proposal, specs, and tasks that referenced the old approach. ## Quick Start Ask the assistant to update the OpenSpec change named add-caching so its design and specs reflect the new decision to use Redis.

Frequently Asked Questions about openspec-update-change

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

FAQPage Schema
How do I update an existing OpenSpec change after a design decision changes?

Invoke the update workflow with the change name, and it reads the change's artifacts via openspec status, applies your requested edit, then checks every other existing artifact for contradictions. Each revision is shown and confirmed before writing.

How does the skill keep OpenSpec artifacts coherent with each other?

It reads all existing artifacts of the change and compares them in any direction, since an edit to a later artifact may require revising an earlier one. It notes inconsistencies, gaps, and duplication, then proposes fixes one artifact at a time.

Can it edit implementation code when the plan changes?

No, it only edits planning artifacts and never touches implementation code. If the revised plan implies code changes, it stops and points you to the apply-change workflow to carry the delta into code.

Does it work with custom OpenSpec schemas and artifact names?

Yes, it uses the artifact ids and concrete file paths reported by openspec status rather than hardcoded names, so custom schemas work unchanged. It edits only existing output paths and never writes to glob patterns.

What happens if artifacts are missing from the change?

It does not create new artifacts or new files under glob artifacts, since that belongs to the continue-change workflow. Missing artifacts are noted and deferred, with a suggestion to run the continue-change command next.

When should I start a new change instead of updating one?

If the request changes the change's intent rather than refining it, starting fresh is recommended. The skill suggests the new-change workflow when available, or asks for a distinct unused name to create a new change via the openspec CLI.