spectra-archive

Archive spectra changes after validating artifacts, tasks, and delta spec sync.

Updated Apr 27, 2026

Search Tags:#archive #change management #spec synchronization #spectra #CLI workflow #automation safety #validation checks

Ready to run

npx skills add https://github.com/zooroy/appt-system --skill spectra-archive-zooroy

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spectra-archive
Source: https://github.com/zooroy/appt-system/tree/main/.agents/skills/spectra-archive
Command: npx skills add https://github.com/zooroy/appt-system --skill spectra-archive-zooroy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you archive a completed change without losing spec/work context, while warning you when artifacts or tasks are still incomplete.

Core Features & Use Cases

Interactive change selection: Lists active (not-yet-archived) changes and prompts the user to choose when the change name is not provided.
Completion checks with confirmations: Verifies artifact completion via spectra status --json and checks for incomplete tasks in the typically present tasks.md, prompting the user before continuing if anything is incomplete.
Delta spec sync assessment: Detects delta specs and summarizes the differences vs main specs, then prompts whether to sync or archive without syncing.
Archive execution and cleanup: Removes stale .spectra/touched/<change-name>.json tracking when present and runs spectra archive <name> with optional flags for advanced workflows.
Clear success/failure reporting: Produces a structured completion summary and includes guidance when the target archive already exists.

Quick Start

Tell the AI to archive the change by running spectra-archive with the change name you want (for example: spectra-archive add-auth).

Frequently Asked Questions about spectra-archive

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

FAQPage Schema

How do I archive a completed spectra change safely?▼

To archive a completed spectra change safely, run the archive process with the change name to validate artifact completion, check task status, and verify delta spec synchronization before execution.

What happens if I try to archive a spectra change with incomplete tasks?▼

When archiving a spectra change with incomplete tasks, the process detects incomplete items in tasks.md via spectra status --json and prompts you for confirmation before continuing the archive execution.

How does delta spec synchronization work during the spectra archive process?▼

Delta spec synchronization during the spectra archive process detects differences between delta specs and main specs, summarizes the changes, and prompts you to either sync the specs or archive without syncing.

Do I need the spectra CLI to run spectra-archive workflows?▼

Yes, you need the spectra CLI installed because spectra-archive requires running spectra list, spectra status, optional spectra-sync-specs, and spectra archive commands to validate and execute the change archiving workflow.

What should I do if the target spectra archive already exists?▼

If the target spectra archive already exists, the process produces a structured completion summary that includes specific guidance on how to handle the existing archive conflict.

How do I clean up stale touched JSON tracking files after archiving a change?▼

To clean up stale touched JSON tracking files after archiving a change, the workflow automatically removes the .spectra/touched/<change-name>.json file during the archive execution and cleanup phase.