openspec-new-change

Creates OpenSpec change requests with proposal, design, tasks, and spec artifacts.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/pavelvdo/universal-xml-exchange2 --skill openspec-new-change-pavelvdo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/pavelvdo/universal-xml-exchange2/tree/main/.cursor/skills/openspec-new-change
Command: npx skills add https://github.com/pavelvdo/universal-xml-exchange2 --skill openspec-new-change-pavelvdo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a 1C development change without a clear specification leads to uncontrolled edits and missed acceptance criteria. This Skill scaffolds a complete OpenSpec change (ЗНИ) — proposal, design, tasks, and spec deltas — in one guided flow, reusing the analysis block from chat or handoff files as the primary input. ## Core Features & Use Cases - Change scaffolding: Creates or resumes an OpenSpec change directory via the openspec CLI, deriving a kebab-case name from the latest «Постановка ЗНИ» block in chat or a recent handoff file. - Gated artifact generation: Builds proposal.md, design.md, tasks.md, and spec deltas in dependency order, enforcing Metadata Gate (developer and comment marker), Forms/MXL Mode Gate, Design Gate (architect review), and Slice Generation Gate before implementation. - Slice-aware task decomposition: Delegates to an architect agent to split work into vertical slices, each with exactly one acceptance task and a primary acceptance checklist. - Use Case: After exploring a defect in chat, run the new-change flow to turn the «Постановка ЗНИ» block into a full change with proposal, design, and slice-based tasks ready for verification and implementation. ## Quick Start Ask the assistant to create a new OpenSpec change from the latest «Постановка ЗНИ» block in the chat, for example by invoking /opsx:new with an optional kebab-case change name.

Frequently Asked Questions about openspec-new-change

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

FAQPage Schema
How do I create a new OpenSpec change from a chat brief?

Invoke the new-change flow without arguments; it auto-detects the most recent «Постановка ЗНИ» block in the session or a handoff file from the last 48 hours. It derives a kebab-case name and generates proposal, design, tasks, and spec artifacts in dependency order.

How do I resume an existing OpenSpec change?

Pass the existing change name as an argument. If the change directory already exists, the skill skips scaffolding, reuses metadata from proposal.md when valid, and continues creating only the missing artifacts required before implementation.

Does this skill require the openspec CLI?

Yes, the openspec CLI is required. The skill runs commands like openspec new change, openspec status, and openspec instructions to scaffold the change directory and determine the artifact build order.

What happens if the design triggers the Architect Gate?

When structural or semantic triggers fire and no architecture report exists, the skill pauses and delegates a design review to the architect agent, saving a report under reports/. You can consciously bypass it only by rerunning with the --skip-architect flag and a reason.

When is slice decomposition mandatory for tasks?

Slice decomposition is mandatory when the estimated work exceeds about five tasks. The architect agent adds a Slices section to design.md, and each slice gets exactly one acceptance task with a primary acceptance checklist in tasks.md.

Why does the skill ask for developer name and comment marker?

The Metadata Gate collects the developer name and a one-phrase Russian description used in code comment markers. If a default developer is set in project.md, only the description draft is confirmed; otherwise the name is asked once and can be saved as default.