openspec-archive-change

Archive completed experimental changes with validated artifacts and tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed experimental changes by finalizing and storing them in an organized archive, ensuring reproducibility and traceability of the workflow.

Core Features & Use Cases

  • Validates that all artifacts are finished before archiving.
  • Verifies that associated tasks are complete, including any delta specs.
  • Archives the change directory under openspec/changes/archive with a date-prefixed name, preserving metadata like .openspec.yaml.
  • Provides a clear, user-friendly summary of actions taken and any warnings.

Quick Start

Archive the completed change named "<change-name>" after confirming all artifacts and tasks are finished.

Frequently Asked Questions about openspec-archive-change

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

FAQPage Schema
How do I archive completed changes in an openspec workflow?

Archiving completed changes involves validating that all artifacts, tasks, and delta specs are finished before moving the directory to openspec/changes/archive. The system enforces a date-prefixed naming convention, preserves metadata like .openspec.yaml, and provides a clear summary of actions taken.

What happens if my openspec change has incomplete artifacts or delta specs?

When incomplete artifacts or delta specs are detected during openspec archiving, the system prompts for user decisions. It validates all associated tasks to ensure completeness before proceeding to finalize and store the change directory in the archive.

Can I preserve openspec metadata like .openspec.yaml when finalizing a change?

Yes, the archiving process explicitly preserves metadata like .openspec.yaml when storing completed changes. This ensures reproducibility and traceability of the workflow by maintaining all original configuration alongside the archived artifacts and delta specs.

Why do I need to validate delta specs before archiving a change?

Validating delta specs before archiving ensures that all associated tasks are fully complete and the workflow remains reproducible. The system checks these artifacts to guarantee only finished changes are finalized and stored in the archive directory.

Does the openspec archive process enforce a specific directory naming convention?

Yes, the openspec archive process enforces a date-prefixed naming convention for directories stored under openspec/changes/archive. This ensures organized storage and traceability of finalized changes.