openspec-update-change

Revise OpenSpec change planning artifacts and reconcile them for coherence.

1|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/pablof7z/pod0 --skill openspec-update-change-pablof7z
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-update-change
Source: https://github.com/pablof7z/pod0/tree/main/.agents/skills/openspec-update-change
Command: npx skills add https://github.com/pablof7z/pod0 --skill openspec-update-change-pablof7z

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a change plan evolves, its existing OpenSpec planning artifacts (proposals, designs, specs, tasks) drift out of sync with each other. This Skill revises the artifacts of an existing change and keeps them mutually consistent without 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 the design now uses a different storage approach, ask the Skill to update the change; it revises the design artifact and reconciles the proposal, specs, and tasks that referenced the old approach. ## Quick Start Ask the assistant to update the OpenSpec change named "add-search-indexing" so its design reflects the new decision and its other artifacts stay consistent.

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 plan?▼

Invoke the update workflow with the change name, or let it infer the change from context. It runs openspec status to list existing artifacts, applies your requested revision, and reconciles the other artifacts for consistency after your confirmation.

How to keep OpenSpec artifacts consistent after a design decision changes?▼

Describe the new decision and the Skill performs a coherence review across all existing artifacts in any direction. It proposes each revision with reasoning and writes only the edits you approve, one artifact at a time.

Does openspec-update-change edit implementation code?▼

No, it only edits planning artifacts such as proposals, designs, specs, and tasks. If the revised plan implies code changes, it stops and points you to the apply-change workflow instead.

Can it create new artifacts or files for a change?▼

No, it only revises files that already exist in existingOutputPaths and never creates new artifacts or files under glob patterns. Creating missing artifacts is delegated to the continue-change workflow.

What happens if the change name is ambiguous or missing?▼

It runs openspec list --json and prompts you with the top 3-4 most recently modified changes, showing schema, task status, and modification time. The most recently modified change is marked as recommended.