---
name: gsd-archive-milestone
description: Use gsd-complete-milestone instead. This command has been unified into the completion workflow. Shows deprecation notice and exits.
allowed-tools: Read
---

# Archive Milestone (DEPRECATED)

**This command has been replaced by gsd-complete-milestone.**

<objective>
DEPRECATED: This command has been unified into gsd-complete-milestone.
</objective>

<process>

<step name="show_deprecation_and_exit">
Display deprecation notice using GSD branded banner format:

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 GSD ► DEPRECATED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

This command has been unified into the milestone completion workflow.

**Old workflow (deprecated):**
1. {{COMMAND_PREFIX}}complete-milestone    # Mark complete
2. {{COMMAND_PREFIX}}archive-milestone     # Move to milestones/ ← YOU ARE HERE
3. {{COMMAND_PREFIX}}restore-milestone     # Retrieve from milestones/

**New workflow (unified):**
{{COMMAND_PREFIX}}complete-milestone       # Archives directly to history/v{X.Y}/

All milestone files now move directly to `.planning/history/v{X.Y}/`
with mirrored directory structure during completion. Archives are
permanent and git-tracked.

───────────────────────────────────────────────────────────────

## Why This Changed

The old multi-step workflow created confusion about when files were
truly archived. The new unified workflow moves everything to permanent
history/ storage in a single atomic operation.

**To review archived milestones:**
{{COMMAND_PREFIX}}list-milestones

**To start new milestone:**
{{COMMAND_PREFIX}}new-milestone

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

Exit immediately without executing any operations.
</step>

</process>

<success_criteria>
- [ ] Deprecation message displayed with branded banner
- [ ] Clear explanation of old vs new workflow
- [ ] User directed to correct command (complete-milestone)
- [ ] No file operations executed
- [ ] Template variables ({{COMMAND_PREFIX}}) used for cross-platform support
</success_criteria>