# cclab:gen:merge-change

> Archive workflow - merge specs and move to archive

- Author: chrischeng-c4
- Repository: chrischeng-c4/cclab
- Version: 20260126151830
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/chrischeng-c4/cclab
- Web: https://mule.run/skillshub/@@chrischeng-c4/cclab~cclab:gen:merge-change:20260126151830

---

---
name: cclab:gen:merge-change
description: Archive workflow - merge specs and move to archive
user-invocable: true
---

# /cclab:gen:merge-change

Orchestrates the archival process, merging spec deltas to main specs and moving the change to the archive directory.

## IMPORTANT: Your role is orchestration only

**DO NOT perform archival steps yourself.** Your job is to:
1. Check the current phase in `STATE.yaml`
2. Run the `genesis merge-change` command

The actual merging and archiving is done by the command, which uses:
- **Gemini** (spec merging)
- **Codex** (archive review)

You are a dispatcher, not an archiver. Run the command and let it handle the work.

## Usage

```bash
/cclab:gen:merge-change <change-id>
```

## Example

```bash
/cclab:gen:merge-change add-oauth
```

## How it works

The skill checks the `phase` field in `STATE.yaml`:

| Phase | Action |
|-------|--------|
| `implemented` | ✅ Run `genesis merge-change` to merge and archive |
| `merging` | ✅ Run `genesis merge-change` to resume archive workflow |
| Other phases | ❌ **ChangeNotComplete** error - not ready for archive |

## What it does

1. **Validates** spec files (zero token cost)
2. **Analyzes** delta metrics and decides merge strategy
3. **Backs up** original specs for rollback
4. **Merges** spec deltas with Gemini (applies changes to `cclab/specs/`)
5. **Generates** CHANGELOG entry
6. **Reviews** merged specs with Codex (with auto-fix loop if needed)
7. **Moves** change to `cclab/archive/YYYYMMDD-<change-id>/`
8. Updates phase to `archived` in STATE.yaml

## Prerequisites

- Change must be implemented (phase: `implemented`)
- All implementation artifacts must exist and pass validation

## State transitions

```
implemented → merging → archived
```

## Error: ChangeNotComplete

This error occurs when trying to archive before implementation is complete:

```
❌ ChangeNotComplete: Change must be in 'complete' phase

Current phase: implementing
Action required: Complete implementation first with /cclab:gen:impl-change <change-id>
```

**Resolution**: Ensure all implementation tasks are complete and tests pass using `/cclab:gen:impl-change`.