# design-cleanup

This skill removes remnants of a discarded design from the affected code, tests, and docs. Use it after an approach changes mid-branch.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3400 installs
- Author: gjkim42
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gjkim42/kanon-repo/tree/HEAD/skills/design-cleanup/SKILL.md
- Updated: 2026-09-09
- HTML: https://affpapa.org/en/nevibecode/skills/design-cleanup

## What it does

design-cleanup searches the current branch for code that still reflects an abandoned decision. It covers dead branches, old parameters, shims, misleading names, transitional comments, stale tests, documentation, and TODOs. The pass is limited to the code touched by that decision, rather than turning into general refactoring or bug hunting.

It first defines the current design and the approach being dropped, then narrows the work to changed files and references to retired concepts. The workflow includes reviewing the branch diff, running the project build and tests, and checking for old names and history-focused terms such as `legacy` or `V2`. If the decision is unclear, broad edits wait for confirmation of that summary.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gjkim42/kanon-repo --skill design-cleanup -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/design-cleanup/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/design-cleanup/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gjkim42/kanon-repo --skill design-cleanup -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/design-cleanup/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gjkim42/kanon-repo --skill design-cleanup -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/design-cleanup/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gjkim42/kanon-repo design-cleanup
```

2. **Manually: put the files in place**
- File: `.github/skills/design-cleanup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gjkim42/kanon-repo --skill design-cleanup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gjkim42/kanon-repo --path skills/design-cleanup
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/design-cleanup/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gjkim42/kanon-repo --skill design-cleanup -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gjkim42/kanon-repo/tree/HEAD/skills/design-cleanup/SKILL.md

## When to use it
- remove branches and parameters used by the old approach
- rename identifiers, files, and modules shaped by the former design
- rewrite tests for the intended API
- replace comments and docs that describe the transition
- find dangling references to retired concepts

## Example prompts
- Run design cleanup after we changed the data-processing approach on this branch.
- Remove the old API’s traces from the affected code, tests, and documentation.
- Review the branch diff, rewrite leftovers from the former design, then run the build and tests.

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [codebase-design](https://affpapa.org/en/nevibecode/skills/codebase-design.md) — skill · 850344 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs

From the same set: [gjkim42/kanon-repo](https://affpapa.org/en/nevibecode/by/gjkim42/kanon-repo.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md