К основному содержанию
скилл CX Codex

archive · rsmdt — скилл для Claude Code: архивирует спецификации

Сводит завершённую спецификацию в файл .start/archive/ и удаляет её рабочую папку. Используйте после реализации, чтобы убрать готовую работу из .start/specs/.

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup
Открыть на GitHub

Что делает archive

Скилл читает требования и решение из spec.md или файлов legacy-спецификации, затем кратко описывает замысел, архитектуру и ключевые файлы реализации. Итоговая запись получает имя .start/archive/[NNN]-[name].md. Если в Git удаётся определить коммит реализации, он попадает в запись; при связи с предыдущей спецификацией скилл добавляет перекрёстные ссылки.

Перед удалением рабочей папки скилл проверяет, что архивный файл существует и не пуст. Затем удаляет каталог .start/specs/[NNN]-[name]/ целиком. Для разрешения спецификации он использует скилл specify-meta; если требований и решения нет, предлагает выбрать между удалением папки и отменой. Без ясного коммита он не придумывает SHA, а записывает unknown.

Какие задачи решает

  • свести требования и архитектуру завершённой спецификации в один файл
  • перенести готовую спецификацию из .start/specs/ в .start/archive/
  • сохранить ссылку на коммит, который реализовал изменение
  • связать новую запись с архивной спецификацией, которую она заменяет

Примеры запросов агенту

  • Запусти /archive 002 и заархивируй завершённую спецификацию.
  • Заархивируй спецификацию payment-processing после реализации.
  • Сохрани требования и архитектуру в архиве, затем удали рабочую папку спецификации 002.

Как установить archive

1Через маркетплейс плагинов

/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup

Команда ставит плагин start целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill archive -a claude-code

3Вручную: положить файлы

~/.claude/skills/archive/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/archive/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об archive

Как установить archive в Claude Code?

В Claude Code добавьте маркетплейс командой /plugin marketplace add rsmdt/the-startup, затем установите плагин командой /plugin install start@the-startup.

Что делает скилл archive?

Он собирает краткую запись о замысле, архитектуре и реализации спецификации в .start/archive/, проверяет файл и удаляет соответствующую папку из .start/specs/.

Что происходит, если скилл не находит коммит реализации?

Если определить коммит не удаётся, скилл предлагает указать SHA или записать unknown. Придумывать коммит он не должен.

Исходный текст

SKILL.md · MIT
---
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
  commit?: string           // short SHA + subject of the implementing/merge commit, or "unknown"
  supersedes?: string[]     // prior archived spec stems ([NNN]-[name]) this one replaces
}

State {
  target = $ARGUMENTS
  sourceDir: string
  requirements?: string     // spec.md (its Requirements part), or requirements.md in a legacy spec
  solution?: string         // spec.md (its Solution part), or solution.md in a legacy spec
  archivePath: string
  commit?: string           // resolved in step 3
  priorArchives?: string[]  // existing .start/archive/*.md scanned for supersession in step 4
}

## Constraints

**Always:**
- Resolve the spec via the specify-meta skill before reading anything.
- Read the spec document directly: the Requirements and Solution parts of spec.md, or requirements.md and solution.md (whichever exist) in a legacy spec.
- 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.
- Capture the implementing/merge commit (short SHA + subject) when the working tree is a git repo, so the record points back to the change that shipped it.
- Scan `.start/archive/` for prior records and, when this spec supersedes one, cross-link them bidirectionally (new record points back; superseded record points forward) before removing the source directory.
- 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.
- Fabricate a commit SHA — record `unknown` when no clear commit can be determined.

## Reference Materials

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

## Workflow

### 1. Resolve

Use the specify-meta skill with `$ARGUMENTS` to read the spec (`node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js {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` and `sdd` paths, if present (both are spec.md; a legacy spec reports requirements.md and solution.md)

```
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 the Requirements and Solution parts (spec.md, or the legacy 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. Identify the Implementing Commit

Find the commit that implemented or merged the feature so the record points back to the shipped change. Search history for the spec ID and name:

```bash
git log -n 5 --oneline --all --regexp-ignore-case --grep "{specId}" --grep "{specName}"
```

```
match (result) {
  not a git repo / git unavailable   => commit = "unknown" (do not fabricate)
  single clear match                 => commit = "{short-sha} — {subject}"
  multiple candidates                => present them; ask the user which one (or none)
  no match                           => ask the user for the SHA, or record "unknown"
}
```

### 4. Check Prior Archives for Supersession

List existing records in `.start/archive/` (skip if the directory does not exist yet). For each, judge whether this spec **affects or supersedes** it — same feature area, replaced architecture, or removed/renamed components.

```
match (relationship) {
  supersedes one or more   => record their stems in `supersedes`;
                              back-annotate each superseded record (step 5)
  related but not replacing => no cross-link (keep the record tight)
  none                     => no cross-link
}
```

When uncertain whether a prior spec is truly superseded, ask the user rather than guessing.

### 5. Write the Archive Record

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

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

**Commit:** {short-sha} — {subject}   <!-- or: unknown -->
**Supersedes:** [NNN]-[name]   <!-- omit this line entirely when nothing is superseded -->

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

## Architecture
{the architecture diagram lifted from the Solution part, 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.

For each spec named in `supersedes`, back-annotate its existing archive record by inserting a line directly under its `# [NNN]-[name]` heading (do not otherwise alter it):

```markdown
**Superseded by:** [NNN]-[name]
```

### 6. Remove the Working Directory

Verify the archive record exists and is non-empty. Record the archive and keep the spec's event log beside its record:

```bash
node ${CLAUDE_PLUGIN_ROOT}/scripts/spec.js {specId} --event '{"kind":"archived"}'
mv {sourceDir}/events.jsonl .start/archive/[NNN]-[name].events.jsonl
```

Then remove the source directory in a single step:

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

The scaffolding (`spec.md`, `review.md`, `.tracker/`, and in legacy specs `plan/`, `units/`, `scenarios/`, `manifest.md`, `README.md`) is removed with it — it all lives inside `sourceDir`.

### 7. Report

Confirm to the user:
- `Archived: [NNN]-[name] → .start/archive/[NNN]-[name].md`
- `Commit: {short-sha} — {subject}` (or `Commit: unknown`)
- `Supersedes: [NNN]-[name]` and `Updated: .start/archive/[NNN]-[name].md` (only when applicable)
- `Removed: {sourceDir}`

© Rudolf S. · MIT · rsmdt/the-startup

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — archive от других авторов.

archive ReScienceLab Скилл archive сохраняет решения сложных багов, шаги деплоя и выводы сессий в локальные markdown-файлы. Ведёт единый индекс памяти проекта между перезапусками агента. CX Codex +1 1 200установок archive kirkchen Скилл archive архивирует завершённое изменение Beat: синхронизирует возможности в живую документацию, перемещает спецификацию в архив и передаёт управление следующему шагу — созданию PR или слиянию ветки. CX Codex +1 524установок archive orwa-mahmoud Скилл archive для Claude Code переносит завершённые смены Nightshift в архивную папку. В активном каталоге остаются только незавершённые задачи и открытые чеки. CX Codex +1 ★ 571звёзд репо unisecurityguard-academic-whistleblower-archive reason-machines Скилл unisecurityguard-academic-whistleblower-archive для Claude Code задаёт шаблон GitHub-репозитория для фиксации давления и нарушений в вузах и сохранения публикаций из соцсетей до удаления. CX Codex +1 1 100установок javaBin archive — Norwegian Java community origins totto javaBin archive — Norwegian Java community origins — MCP-сервер для Claude Code с архивом ранней истории javaBin и JavaZone. Отдаёт агенту факты о сообществе, а не догадки. CX Codex +1 annas-archive-ebooks ratacat Скилл annas-archive-ebooks ищет и скачивает электронные книги из Anna's Archive по названию или автору в форматах PDF, EPUB, MOBI. Нужна членская карта архива. CX Codex +1 2установок pp-archive-is Matt Van Horn Скилл pp-archive-is ищет копии страниц, обходит пейволлы и отправляет адреса в веб-архивы с автоматической сменой бэкенда. Пригодится агенту для чтения закрытых статей и пакетного сохранения ссылок. CX Codex +1 657установок platform-trust-archive-manage forcedotcom Скилл platform-trust-archive-manage для работы с Salesforce Archive через Archive Connect API: поиск, восстановление, маскирование и удаление архивных записей. CX Codex +1 5 200установок groove-utilities-task-archive andreadellacorte Скилл groove-utilities-task-archive архивирует завершённые и отброшенные задачи в настроенном бэкенде. Подходит для ручного закрытия накопившихся задач с подтверждением. CX Codex +1 533установок

Из того же набора50

Весь набор →
validate Скилл validate запускает проверку спецификаций, кода, расхождений с реализацией и правил конституции проекта через специализированных субагентов. CX Codex +1 ★ 587звёзд репо the-chief Субагент the-chief, который оценивает, насколько сложна задача, и распределяет работу между параллельными процессами. Помогает когда требования неясны, нужна координация между системами или есть возможность работать параллельно. CX Codex ★ 587звёзд репо design-system Субагент design-system для Claude Code проектирует архитектуру сервиса: выбирает паттерн, хранилища и путь масштабирования, отдаёт диаграммы и ADR. Помогает решить, дробить ли монолит. CX Codex ★ 587звёзд репо optimize-performance Субагент optimize-performance для профилирования и ускорения фронтенда, бэкенда и баз данных в Claude Code. Помогает при росте задержек API, утечках памяти и тяжёлых бандлах. CX Codex ★ 587звёзд репо implement Скилл implement для Claude Code оркестрирует реализацию по готовой спецификации: запускает цикл «код → оценка» до прохождения holdout-сценариев. CX Codex +1 ★ 587звёзд репо debug Скилл debug для Claude Code пошагово расследует ошибки: проверяет воспроизводимость, ведёт реестр гипотез и подтверждает первопричину. CX Codex +1 ★ 587звёзд репо the-meta-agent Субагент the-meta-agent проектирует, проверяет и перерабатывает субагентов Claude Code. Он нужен для выбора структуры, границ и сценария работы нового агента. CX Codex ★ 587звёзд репо improve Скилл improve ищет модули с раздутыми интерфейсами и предлагает рефакторинги, которые превращают их в глубокие — тестируемые и удобные для навигации агентом. CX Codex +1 ★ 587звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой