openspec-apply-change

Apply OpenSpec change plans by executing tasks sequentially with progress reporting.

Updated Feb 12, 2021
One-click install
npx skills add https://github.com/echowaves/WiSaw.cdk --skill openspec-apply-change-echowaves
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-apply-change
Source: https://github.com/echowaves/WiSaw.cdk/tree/main/.roo/skills/openspec-apply-change
Command: npx skills add https://github.com/echowaves/WiSaw.cdk --skill openspec-apply-change-echowaves

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you implement an OpenSpec change by converting the change definition into concrete, ordered task work you can execute in your repo.

Core Features & Use Cases

  • Select and validate a change: Infers or prompts for the correct active change and verifies schema/task context before editing.
  • Generate apply instructions and context: Pulls the current apply plan (including dynamic instructions and progress) and reads all required context files.
  • Execute tasks safely and incrementally: Performs each pending task, updates task checkboxes as you complete work, and pauses when tasks are unclear or blocked.
  • Use with “actions on a change” workflows: Supports starting, resuming, or continuing implementation at any time with progress tracking.

Quick Start

Run openspec apply for the intended change by invoking the workflow and selecting the change name when prompted.

Frequently Asked Questions about openspec-apply-change

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

FAQPage Schema
How do I apply code changes from a spec-driven workflow to my repository?

You can resume task orchestration by running the apply workflow for your active change. It checks the current status of pending tasks, reads necessary context files, and continues sequential execution while updating progress checkboxes.

What happens when an implementation task is unclear or blocked during code execution?

When a task is unclear or blocked during code execution, the workflow pauses. It adheres to guardrails for blocked, unclear, or error states, ensuring safe and incremental task execution without proceeding past unresolved issues.

Do I need the OpenSpec CLI to automate change management and task execution?

Yes, applying change plans requires the OpenSpec CLI. The process parses JSON outputs from status and instructions commands to generate dynamic apply instructions, validate schemas, and track task progress in your codebase.

How does schema driven workflow automation handle non-spec-driven changes?

Schema driven workflow automation supports non-spec-driven changes by reading required contextFiles and executing tasks sequentially. It validates the schema and task context before editing, ensuring safe implementation regardless of the change type.

Can I track progress incrementally when implementing code changes from a plan?

Yes, progress tracking updates task checkboxes as you complete work. The workflow performs each pending task safely and incrementally, pulling the current apply plan and reporting dynamic progress updates throughout the implementation.