spectra-archive

Validate artifacts, tasks, and delta specs before archiving a Spectra change.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/SeanChenR/maestro-agent --skill spectra-archive-seanchenr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-archive
Source: https://github.com/SeanChenR/maestro-agent/tree/main/.claude/skills/spectra-archive
Command: npx skills add https://github.com/SeanChenR/maestro-agent --skill spectra-archive-seanchenr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the finalization and archival of a completed Spectra change by validating artifact and task completion, assessing and optionally syncing delta specs, and performing the repository archive operation so teams can reliably retire change branches and capture a snapshot for records.

Core Features & Use Cases

  • Interactive selection: Prompt the user to choose an active change when a name is not provided.
  • Validation checks: Use spectra status output and local tasks files to surface incomplete artifacts and tasks and require explicit confirmation before proceeding.
  • Delta spec assessment and sync: Compare change delta specs with main specs, summarize diffs, and optionally invoke a sync workflow before archiving.
  • Deterministic archive execution: Run the spectra archive command with sensible flag options and handle common error cases (e.g., existing archive target).
  • Clear summaries and guardrails: Preserve .openspec.yaml, always show results, and provide recovery options when archives already exist.

Quick Start

Archive the change named add-auth by confirming the interactive prompts and then running the archive workflow through the Skill which will validate artifacts, tasks, and delta specs before executing the spectra archive operation.

Frequently Asked Questions about spectra-archive

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

FAQPage Schema
How do I archive completed Spectra changes safely?

Spectra change archival requires the spectra CLI, read access to openspec/changes and openspec/specs paths, and optionally interactive tools for user selection and task-driven sync operations.

How do I validate completion state before archiving a Spectra change?

Validating completion state before archiving involves checking spectra status output and local tasks files to surface incomplete artifacts and tasks, requiring explicit confirmation before proceeding with the archive operation.

How do I sync delta specs to main specs during the change archival process?

Syncing delta specs to main specs during change archival compares change delta specs with main specs, summarizes the diffs, and optionally invokes a sync workflow before executing the final spectra archive operation.

What happens if the target archive already exists in Spectra?

If the target archive already exists in Spectra, the archival process handles the common error case by providing recovery options, preserving .openspec.yaml, and showing clear results to guide the user through resolution.

Can I interactively select a Spectra change to archive?

Yes, you can interactively select an active Spectra change to archive when a specific change name is not provided, allowing the workflow to prompt you for a choice before validating and archiving.