openspec-new-change

Scaffold a new OpenSpec change with the artifact-driven workflow.

40|84|Updated Oct 4, 2022
One-click install
npx skills add https://github.com/mendix/web-widgets --skill openspec-new-change-mendix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/mendix/web-widgets/tree/main/.agents/skills/openspec-new-change
Command: npx skills add https://github.com/mendix/web-widgets --skill openspec-new-change-mendix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec change initiation is error-prone and manual; this skill automates scaffolding a new change using the experimental artifact-driven workflow, providing a repeatable template and guidance.

Core Features & Use Cases

  • Automated scaffolding: Creates the openspec/changes/<name> scaffold with initial structure and metadata.
  • Guided first artifact: Supplies instructions for the first artifact according to the chosen workflow.
  • Input validation & guardrails: Validates kebab-case name and ensures safe steps without creating artifacts.
  • Use Case: Start a new feature, bug fix, or modification in an OpenSpec project with a consistent, repeatable process.

Quick Start

Run openspec new change 'openspec-new-change' to scaffold the change and then follow the prompts to proceed.

Frequently Asked Questions about openspec-new-change

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

FAQPage Schema
How do I scaffold a new OpenSpec change using the artifact-driven workflow?

Scaffolding a new OpenSpec change requires running the command to create the directory structure at openspec/changes/<name> with initial metadata. It provides status updates, first-artifact instructions, and guardrails without creating the actual artifacts.

What is the artifact-driven workflow for OpenSpec change management?

The artifact-driven workflow is a structured, step-by-step process for creating features, fixes, or amendments. It automates scaffolding the change directory and supplies guidance for generating the initial artifact according to the chosen workflow.

Do I need the OpenSpec CLI to create a new change scaffold?

Yes, creating a new OpenSpec change scaffold requires the OpenSpec CLI. The CLI automates the generation of the openspec/changes/<name> directory structure and enforces the input validation guardrails.

How does OpenSpec validate change names during scaffolding?

OpenSpec validates change names by enforcing kebab-case formatting during the scaffolding process. This input validation ensures safe steps and consistent naming conventions before generating the directory structure.

Does the OpenSpec scaffolding process create the first artifact automatically?

No, the OpenSpec scaffolding process does not create the first artifact automatically. It produces the scaffold and provides instructions and guardrails for the user to follow the artifact-driven workflow manually.

When should I use an automated scaffold for OpenSpec change management?

Use an automated scaffold when starting a new feature, bug fix, or modification to ensure a repeatable process. It eliminates manual errors by providing a consistent template and guided steps for the artifact-driven workflow.