Archive Artifacts

Use this skill when a maintainer needs an explicit archival step that preserves durable history without broad cleanup side effects.

Responsibilities

1. Discover archive candidates across proposals, features, subfeatures, and closed slices.
2. Keep candidate reporting read-only by default.
3. Archive one closed execution slice explicitly through the execution owner helper.
4. Summarize closed slices for one feature or subfeature into system-design.md before archiving them.

Preferred Input

• no arguments for archive candidate discovery
• optional artifact-type filtering
• --artifact-type slice --artifact-id <id> --apply for one closed-slice archival
• --artifact-type feature --artifact-id <feature-slug> --apply to summarize and archive all closed planned slices for one feature
• --artifact-type subfeature --artifact-id <subfeature-id-or-path> --apply to summarize and archive all closed planned slices for one subfeature

Tooling

# Report archive candidates
python3 skills/archive-artifacts/scripts/archive_artifacts.py

# Filter to one artifact type
python3 skills/archive-artifacts/scripts/archive_artifacts.py --artifact-type proposal

# Archive one closed slice
python3 skills/archive-artifacts/scripts/archive_artifacts.py \
  --artifact-type slice \
  --artifact-id CAM-03-artifact-state-report \
  --apply

# Summarize and archive closed slices for one feature
python3 skills/archive-artifacts/scripts/archive_artifacts.py \
  --artifact-type feature \
  --artifact-id execution-workflow \
  --apply

# Summarize and archive closed slices for one subfeature
python3 skills/archive-artifacts/scripts/archive_artifacts.py \
  --artifact-type subfeature \
  --artifact-id audit-artifacts \
  --apply

# Emit machine-readable output
python3 skills/archive-artifacts/scripts/archive_artifacts.py --json

Output

• default: human-readable candidate summary
• --json: structured candidates and optional apply outcome

Exit behavior:

• 0 when the archive command succeeds
• 2 for unsupported or invalid apply requests

Guardrails

• Keep candidate discovery read-only.
• Delegate slice archival to the execution owner helper instead of moving slice folders directly here.
• For feature and subfeature apply mode, summarize slice history into system-design.md before archiving the targeted closed slices.
• Keep archival explicit and scoped; do not bulk archive across unrelated features by default.