openspec-update-change

Revises existing OpenSpec change planning artifacts and keeps them mutually coherent.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/aguachis/Nicole-DB --skill openspec-update-change-aguachis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-update-change
Source: https://github.com/aguachis/Nicole-DB/tree/main/.agents/skills/openspec-update-change
Command: npx skills add https://github.com/aguachis/Nicole-DB --skill openspec-update-change-aguachis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a decision changes mid-planning, OpenSpec change artifacts (proposals, designs, specs, tasks) drift out of sync. This Skill revises the existing artifacts of a change and reconciles them against each other so the plan stays consistent, without ever touching implementation code. ## Core Features & Use Cases - Coherence Review: Reads all existing artifacts of a change and detects contradictions, gaps, and duplication in any direction, not just build order. - 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 --json, so custom schemas work without hardcoded assumptions. - Use Case: After deciding to switch the design to a new approach, ask the Skill to update the change; it revises the design artifact, then checks the proposal, specs, and tasks for anything now inconsistent and proposes fixes. ## Quick Start Ask the assistant to update the OpenSpec change named "add-user-auth" so its artifacts reflect the new design decision and stay consistent with each other.

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 OpenSpec change after a design decision changes?▼

Invoke the update workflow with the change name; it reads the change's artifacts via openspec status, applies your requested edit, then checks every other existing artifact for contradictions and proposes confirmed revisions one at a time.

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

It reads all existing artifacts of the change and cross-checks them in any direction, since an edit to a later artifact may require revising an earlier one. It flags inconsistencies, gaps, and duplication, then proposes fixes only for files that already exist.

Does the OpenSpec update workflow work with custom schemas?▼

Yes. It takes artifact ids and paths directly from the openspec status JSON response rather than hardcoding artifact names, so custom schemas work unchanged. It edits only concrete files in existingOutputPaths, never glob patterns.

Can the update change skill create new artifacts or edit code?▼

No. It only revises artifacts that already exist and never touches implementation code. Missing artifacts are deferred to the continue-change workflow, and code changes implied by a revised plan are deferred to the apply-change workflow.

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

Start fresh when the request changes the change's intent rather than refining it. The skill checks whether the new-change workflow is available and recommends it, or suggests running openspec new change with a distinct unused name.