archive git:20260930.a14872bA

Immutable. This exact content never changes and is served at /api/v1/blob/060a3f630c4ec20f.

---
name: archive
description: Consolidate a completed specification into a single archived record and remove its working directory. Use as the final stage after implementation — distills requirements + solution into .start/archive/[NNN]-[name].md and deletes the .start/specs/[NNN]-[name]/ directory.
user-invocable: true
argument-hint: "spec ID to archive (e.g., 002), or spec name"
---

## Persona

Act as a specification archivist. When a spec's implementation is done, consolidate its intent and architecture into a single flat record under `.start/archive/`, then remove the working spec directory. The directory's disappearance from `.start/specs/` is the "done" signal — active work lives in `.start/specs/`, completed work lives in `.start/archive/` as one file per spec.

**Archive Target**: $ARGUMENTS

## Interface

ArchiveRecord {
  specId: string            // 3-digit, e.g., "002"
  specName: string          // e.g., "payment-processing"
  archivePath: string       // .start/archive/[NNN]-[name].md
  sourceDir: string         // .start/specs/[NNN]-[name]/ — removed on completion
}

State {
  target = $ARGUMENTS
  sourceDir: string
  requirements?: string     // path to requirements.md if present
  solution?: string         // path to solution.md if present
  archivePath: string
}

## Constraints

**Always:**
- Resolve the spec via the specify-meta skill before reading anything.
- Read requirements.md and solution.md directly — whichever exist.
- Write the archive record to `.start/archive/[NNN]-[name].md` BEFORE removing anything.
- Verify the archive record exists and is non-empty before removing the source directory.
- Remove the entire `.start/specs/[NNN]-[name]/` directory in a single step once the record is written.
- Keep the record short: high-level intent, architecture, and implementation references. Nothing else.
- Write the record yourself — do not spawn a subagent.

**Never:**
- Remove the source directory before the archive record is confirmed written and non-empty.
- Include user stories, Gherkin, EARS, acceptance criteria, or decision logs in the record.
- Restate requirements or solution verbatim — distill them.
- Pad the record with ceremony, narrative, or status fields.
- Require git, passing tests, or 100% completion — archive records what was done, in whatever state it is.

## Reference Materials

This skill is intentionally self-contained; the record structure is inlined in step 3.

## Workflow

### 1. Resolve

Use the specify-meta skill with `$ARGUMENTS` to read the spec (`spec.py {id} --read`). From the TOML output capture:
- `dir` → `sourceDir` (e.g., `.start/specs/002-payment-processing/`)
- the directory basename `[NNN]-[name]` → archive filename stem
- `prd` (requirements.md) and `sdd` (solution.md) paths, if present

```
match (resolution) {
  spec not found                         => report the error and stop
  neither requirements nor solution      => nothing to distill; ask the user whether to
                                            remove the directory anyway or abort
  at least one of requirements/solution  => proceed to step 2
}
```

### 2. Read Intent

Read requirements.md and solution.md (whichever exist). Extract only:
- **Intent** — what the feature is and why it exists (from requirements).
- **Architecture** — the components, how they fit, and any architecture diagram (from solution).
- **Implementation references** — the key modules/files and where they live (from solution).

Distill. Do not copy sections across; rewrite them to their high-level essence.

### 3. Write the Archive Record

Create `.start/archive/` if it does not exist. Write `.start/archive/[NNN]-[name].md`:

```markdown
# [NNN]-[name]

## What this is
{one or two plain sentences: the feature and its intent}

## Architecture
{the architecture diagram lifted from solution.md, or a minimal one synthesized from
 its components; a short paragraph on how the pieces fit}

## Implementation
{key components/modules and where they live — the references for how it was built}
```

No frontmatter. No other sections. Keep it tight.

### 4. Remove the Working Directory

Verify the archive record exists and is non-empty. Then remove the source directory in a single step:

```bash
rm -rf {sourceDir}
```

The scaffolding (`plan/`, `units/`, `scenarios/`, `manifest.md`, `README.md`) is removed with it — it all lives inside `sourceDir`.

### 5. Report

Confirm to the user:
- `Archived: [NNN]-[name] → .start/archive/[NNN]-[name].md`
- `Removed: {sourceDir}`