openspec-new-change

Scaffold a new OpenSpec change with a guided artifact workflow.

6.2k|152|Updated Feb 7, 2024
One-click install
npx skills add https://github.com/PBH-BTN/PeerBanHelper --skill openspec-new-change-pbh-btn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-new-change
Source: https://github.com/PBH-BTN/PeerBanHelper/tree/main/.claude/skills/openspec-new-change
Command: npx skills add https://github.com/PBH-BTN/PeerBanHelper --skill openspec-new-change-pbh-btn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a guided, artifact-driven workflow to bootstrap a new OpenSpec change, reducing ambiguity and setup time.

Core Features & Use Cases

  • Guided change creation: scaffolds a new OpenSpec change using the experimental artifact workflow.
  • Schema-aware workflow: uses the default workflow or a specified schema to tailor the artifact sequence.
  • Artifact lifecycle visibility: checks status and provides instructions for the first artifact to draft.

Quick Start

Open the OpenSpec CLI and run openspec new change "openspec-new-change" to scaffold the change, then run openspec status --change "openspec-new-change" to view artifact readiness and the first artifact instructions.

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 with a guided workflow?

To scaffold an OpenSpec change, run the CLI command to initialize the project, which sets up a repeatable, step-by-step artifact workflow. This process checks readiness and presents instructions for the first artifact to draft.

What is an artifact-driven workflow for change management?

An artifact-driven workflow for change management bootstraps feature requests or fixes by generating structured artifacts in a sequence. It reduces ambiguity by enforcing a schema and guiding users step-by-step through the creation process.

Can I use a custom schema for OpenSpec change scaffolding?

Yes, OpenSpec change scaffolding supports using a default or specified schema to tailor the artifact sequence. This schema-aware workflow ensures the generated artifacts meet your specific structural requirements.

How do I check artifact readiness in an OpenSpec change?

You can check artifact readiness by running the status command in the OpenSpec CLI. This command views the current status of the change and provides the instructions needed to draft the next artifact.

Does the OpenSpec CLI support both feature requests and bug fixes?

Yes, the OpenSpec CLI supports bootstrapping changes for feature requests, fixes, or modifications. The guided artifact workflow adapts to handle various types of project updates within a repeatable process.

What are the limitations of using scaffolding for OpenSpec change management?

The scaffolding workflow for OpenSpec change management currently relies on an experimental artifact workflow. Users should verify that the default or specified schema aligns with their project's specific structural requirements before proceeding.