mcpField
O
openspec-archive

openspec-archive

github.com/full-stack-skillsDevelopment188 installsUpdated 4w ago
Repository

About openspec-archive

openspec-archive is a skill for finalizing a completed OpenSpec change. It syncs delta specifications into the main specs directory and preserves the change artifacts in an archive.

Key features

  1. 01Checks artifact and task completion
  2. 02Merges added, modified, and removed specs
  3. 03Moves changes into a dated archive
  4. 04Preserves change context for audit

Use cases

  1. 01Archiving a verified change
  2. 02Syncing delta specs into main specs
  3. 03Preserving completed change records

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-archive

After installing, type/openspec-archivein Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

OpenSpec Archive Skill

Use /opsx:archive to finalize a completed change. Archives by merging delta specs into the main openspec/specs/ directory and moving the change folder to openspec/changes/archive/.

When to Use

  • Implementation is complete and verified.
  • The user says "archive", "finish", "done with this change", "wrap up".
  • After running openspec-verify (optional but recommended).

Prerequisites

  • Change exists with artifacts and (ideally) completed tasks.

Workflow

  1. Run archive

    • /opsx:archive — archive the current/inferred change.
    • /opsx:archive <change-name> — archive a specific change.

  2. What happens

    1. Checks artifact completion status and task completion (warns if incomplete).
    2. Offers to sync delta specs if not already synced (see openspec-sync).
    3. Merges delta specs into openspec/specs/ (ADDED / MODIFIED / REMOVED sections).
    4. Moves the change folder to openspec/changes/archive/YYYY-MM-DD-<name>/.

  3. All artifacts preserved

    • The full change context (proposal, design, tasks, specs) is preserved in the archive for audit trail.

Delta Spec Merge Rules

SectionWhat happens
## ADDED RequirementsAppended to main spec
## MODIFIED RequirementsReplaces existing requirement in main spec
## REMOVED RequirementsDeleted from main spec

Outputs

  • Delta specs merged into openspec/specs/.
  • Change moved to openspec/changes/archive/YYYY-MM-DD-<name>/.

Next Steps

  • Start a new change with openspec-new.
  • The main specs now reflect the changes — future changes build on the updated source of truth.

Troubleshooting

  • "Incomplete tasks": Archive warns but does not block. Decide whether to complete tasks first or archive as-is.
  • "Delta specs not synced": Archive will prompt to sync; or run openspec-sync beforehand.
  • Multiple changes to archive: Use openspec-bulk-archive instead.

References

Comments

Markdown supported