---
name: archive-kb
description: "Archive completed knowledge-base artifacts (brainstorms, plans, specs) to their archive/ subdirectories with timestamp prefixes and git history preservation."
triggers:
- archive knowledge base
- archive-kb
- archive brainstorm
- archive artifacts
---

# Archive Knowledge-Base Artifacts

Archive brainstorms, plans, and spec directories for a completed feature branch.
The script generates timestamps internally and uses `git mv` to preserve history.

## Usage

Run the archive script from the repository root. It derives the feature slug
from the current branch name automatically:

```bash
bash ./plugins/soleur/skills/archive-kb/scripts/archive-kb.sh
```

To preview what would be archived without making changes:

```bash
bash ./plugins/soleur/skills/archive-kb/scripts/archive-kb.sh --dry-run
```

To archive a specific slug (override branch detection):

```bash
bash ./plugins/soleur/skills/archive-kb/scripts/archive-kb.sh my-feature-slug
```

## What It Archives

The script discovers artifacts matching the feature slug:

| Directory | Match Pattern | Type |
|-----------|--------------|------|
| `knowledge-base/project/brainstorms/` | Filename contains slug | File glob |
| `knowledge-base/project/plans/` | Filename contains slug | File glob |
| `knowledge-base/project/specs/feat-<slug>/` | Exact directory name | Directory match |

All `archive/` subdirectories are excluded from discovery.

## When to Use

- After completing a feature when brainstorm/plan artifacts should be archived
- During the ship workflow to archive feature artifacts before merge

## Notes

- The script calls `git add` before `git mv` to handle untracked files
- A single timestamp is generated per invocation for consistency
- Exit code 0 for success (including "no artifacts found")
- Exit code 1 for errors (not in git repo, invalid arguments)
- Spec directories are moved as a whole via `git mv` on the directory