Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-cleanup

hyper-cleanup

Verified

Use this skill when someone asks to clean up, delete, or consolidate code, tests, comments, or dead weight in a repository that already works, and the cleanup must not change behavior. It names each in-scope unit as a slop category or a keeper, walks a delete-reuse-platform-simplify ladder, locks behavior with a runnable baseline before the first edit, proves each test deletion or consolidation with a source mutation that is restored byte for byte, and writes a report under `.hyper/cleanup/`. Do not use for authoring new behavior, refactoring a public API, migrating dependencies, or formatting a whole repository.

FileKindSize
SKILL.ko.mdmarkdown18.4 KB
SKILL.mdskill md17.5 KB
assets/evals/hyper-cleanup-cases.jsonlother9.0 KB
rules/behavior-lock.ko.mdmarkdown5.8 KB
rules/behavior-lock.mdmarkdown5.4 KB
rules/categories.ko.mdmarkdown9.6 KB
rules/categories.mdmarkdown8.9 KB
rules/correction-and-report.ko.mdmarkdown7.2 KB
rules/correction-and-report.mdmarkdown6.8 KB
rules/existence-ladder.ko.mdmarkdown6.4 KB
rules/existence-ladder.mdmarkdown5.8 KB
rules/test-junk.ko.mdmarkdown9.6 KB
rules/test-junk.mdmarkdown8.9 KB
scripts/mutation-proof.shexecutablescript11.7 KB
scripts/scan-test-junk.shexecutablescript11.7 KB

rules/existence-ladder.ko.md

View on GitHub
# 존재 사다리

범위 안의 단위가 무엇이 될지 고르기 전에 이 파일을 읽습니다. 네 단, 시도하는 순서, 그리고 삭제 자격을 얻는 증명을 맡습니다.

## 1. 네 단, 이 순서로

범위 안의 모든 단위는 증명할 수 있는 가장 높은 단을 차지하고, 사다리는 위에서부터 시도합니다.

| 단 | 결정 | 필요한 증명 |
|---|---|---|
| 1 | 삭제 | 아무것도 이 단위에 닿지 않거나, 지키는 쪽이 이미 그 계약을 소유한다 |
| 2 | 재사용 | 이 저장소의 기존 도우미, 모듈, 패턴이 같은 일을 한다 |
| 3 | 플랫폼 사용 | 표준 라이브러리, 네이티브 기본 기능, 이미 설치된 의존성이 덮는다 |
| 4 | 제자리 단순화 | 위 어느 것도 해당하지 않는다. 단위는 남고 본문만 바뀐다 |

1단은 동작을 없애는 유일한 단이라 가장 무거운 증명을 집니다. 2단과 3단은 코드를 다른 것으로 바꿔 없애고, 4단은 살아남는 모든 것의 기본값입니다.

사다리는 할당량이 아닙니다. 모든 단위가 4단에 이르는 파일은 정상적인 결과이고, 아무것도 지우지 않은 실행도 유효한 실행입니다.

## 2. 1단: 삭제

삭제에는 의견이 아니라 권한이 필요합니다.

- **참조 없음.** 정의, 호출 형태, 이름의 문자열 형태, 빌드 진입점을 저장소 전체에서 검색해 아무것도 나오지 않습니다. 검색은 생성 코드, 템플릿, 설정 키, 테스트 fixture까지 덮습니다.
- **지키는 쪽이 계약을 소유.** 테스트나 호출 경로가 다른 것과 중복되면 더 강한 쪽이 남고 약한 쪽이 갑니다. 보고서가 지키는 쪽을 이름으로 댑니다.
- **닿지 않음.** 소유자가 받는 어떤 입력에서도 조건이 성립할 수 없는 분기를 호출자의 타입이나 검증으로 증명합니다.

사용자에게 보이는 동작은 내가 쓰지 않았을 것이라는 이유로 추측이 되지 않습니다. 공개 export, 문서화된 플래그, 지원 플랫폼 경로, 손으로 돌릴 수 있는 스크립트는 참조 검색이 아니라고 할 때까지 살아 있습니다.

파일을 지우면 그 import, 테스트 참조, 문서 링크, 설정 항목도 함께 사라집니다. 반쯤 지운 단위는 깨진 빌드입니다. 한 번에 끝내거나 시작하지 않습니다.

## 3. 2단: 재사용

대체 본문을 쓰기 전에 이미 있는 것을 찾습니다.

- 공유 모듈에 다른 이름으로 있는 같은 작업
- 인자 하나를 더 받으면 되는 같은 계층의 도우미
- 새 코드가 베껴야 할, 코드베이스가 의도적으로 반복하는 패턴

재사용은 호출부가 이전과 같은 작업을 읽는다는 뜻입니다. 공유 도우미를 받아들이면 호출부에 적응 코드 세 줄이 필요하다면 그 도우미는 같은 일이 아니고, 단위는 4단에 남습니다.

재사용은 공개 시그니처를 넓히지 않고, 호출자 하나를 위해 공유 도우미에 선택 인자를 더하지 않습니다. 그것은 실제 비용이 있는 새 추상화이고 별도 변경에 속합니다.

## 4. 3단: 플랫폼

표준 라이브러리, 언어 기본 기능, 프로젝트가 이미 설치한 의존성은 손으로 쓴 코드보다 대개 더 많이 덮습니다.

- 언어에 있는 재시도 루프를 손으로 만든 경우
- 문자열 연결로 만든 경로 결합
- 런타임이 이미 읽는 형식을 위한 자체 파서
- 이미 설치된 의존성이 노출하는 함수를 위해 들여온 도우미

네이티브 대체는 오류 동작과 지원 환경까지 포함한 관찰 가능한 계약을 보존해야 합니다. 손으로 쓴 것이 기본값을 돌려주던 자리에서 플랫폼 호출이 예외를 던진다면 동등하지 않고, 교체는 승인되지 않습니다.

새 의존성 설치는 어떤 단도 아닙니다. 사다리는 같은 의존성으로 코드를 줄이는 쪽으로 움직이고, 새 패키지는 동작 보존 정리 밖의 결정입니다.

## 5. 4단: 제자리 단순화

살아남는 모든 것은 자리와 시그니처를 지킵니다. 본문만 바뀌고, [categories.md](categories.md)가 안전하다고 증명한 분류 안에서만 바뀝니다.

제자리 단순화는 건강한 정리의 대부분이 도착하는 자리입니다. 중첩 블록 대신 조기 반환, 이름 붙인 술어가 되는 가드, 한 번에 읽는 반복문, 같은 파일 안의 상수가 되는 중복 리터럴입니다.

## 6. 단을 기록한다

보고서는 범위 안의 단위마다 단과 이유를 한 줄로 적습니다. 1단과 2단 줄은 그것을 증명한 것도 이름으로 댑니다. 검토자가 문제 삼을 두 단이기 때문입니다.

```text
path/to/file.ts:42  rung 4  중첩 삼항을 if/else로 폄; 같은 분기, 같은 순서
path/to/helper.ts:8 rung 1  코드·템플릿·설정·테스트 어디에도 참조 없음; 지키는 쪽: tests/owner.spec.ts
```

검토하고 남겨 둔 단위도 남은 이유와 함께 기록합니다. 보고서는 수정의 기록이 아니라 결정의 기록입니다.

## Sources

> Checked 2026-11-10.

| Claim | Source |
|---|---|
| 삭제 사다리: 쓰지 않거나 이미 소유됐으면 삭제, 그다음 기존 도우미 재사용, 그다음 표준 라이브러리나 설치된 의존성, 그다음 제자리 단순화 | `dbc-hbin/omp-ulw@74df40f remove-ai-slops/SKILL.md` (mechanism reference, re-authored) |
| 사용자에게 보이는 기존 동작은 에이전트가 쓰지 않았을 것이라는 이유로 추측이 되지 않음 | `dbc-hbin/omp-ulw@74df40f remove-ai-slops/SKILL.md` (mechanism reference, re-authored) |
| 네이티브 대체는 관찰 가능한 계약, 접근성, 지원 환경을 보존해야 함 | `dbc-hbin/omp-ulw@74df40f remove-ai-slops/SKILL.md` (mechanism reference, re-authored) |
| 테스트 삭제에는 이름 붙인 지키는 쪽이나 분류 증명이 필요 | `dbc-hbin/omp-ulw@74df40f programming/references/testing/junk-classes.md` (mechanism reference, re-authored) |
| 네 단 보고 형태 | integrator contract, 2026-11-10 (issue #24) |

### Evidence grade

`LOCAL` - 단 번호, 4단 기본값, 검토하고 남긴 단위도 보고하는 규칙은 이 패키지의 설계입니다. 사다리 순서와 "새 의존성 없음" 제한은 라이선스가 없는 저장소에서 자기 말로 다시 썼으며 텍스트나 코드를 복사하지 않았습니다.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall