omd-release-hygiene

Name: omd-release-hygiene
Author: kwakseongjae

365stars35forks

How to install omd-release-hygiene?

kwakseongjae/oh-my-design/omd-release-hygiene

$npx -y skills add kwakseongjae/oh-my-design --skill omd-release-hygiene

Installs into the current project.

Summary

오픈소스 릴리스 위생 루틴. 새 기능/스킬/에이전트를 추가했을 때 (1) 부산물(v1/v2 .bak, _source, 로그, scratch dir)이 changeset에 없는지, (2) 문서(README/docs/home)가 동기화됐는지, (3) npm 배포 대상인지(skills/ + files vs .claude local-preview) 판단했는지 체크리스트로 강제. '릴리스 준비', '커밋 전 점검', 'push 전에 정리', '배포 위생', 'release hygiene' 류 트리거. hu

Files · 1

View on GitHub

SKILL.md

1	# omd:release-hygiene
2
3	오픈소스 레포가 "최적의 결과물만 push"하도록 강제하는 루틴. 실험 과정에서 생긴 부산물이 public repo로 새는 것을 막고, 새 deliverable이 문서/패키징과 어긋나지 않게 한다.
4
5	자동 게이트는 [`scripts/check-release-hygiene.sh`](../../../scripts/check-release-hygiene.sh)가 husky `pre-commit`에서 돌린다. 이 스킬은 그 게이트가 잡지 못하는 판단(문서 동기화, npm 배포 여부)을 사람/에이전트가 책임지게 한다.
6
7	## 0. 언제 트리거하나
8
9	- 새 스킬 / 에이전트 / CLI 플래그 / 큰 기능을 추가한 직후
10	- 커밋 또는 push 직전 ("정리하고 올리자")
11	- 실험(`experiments/`, `.promo/`)을 돌린 세션의 마무리
12
13	## 1. 4-항목 체크리스트 (전부 통과해야 push)
14
15	### [1] 부산물 0건 (자동 + 수동)
16
17	자동: `bash scripts/check-release-hygiene.sh staged` — pre-commit이 이미 실행.
18	수동 확인 대상 (게이트 정규식 밖일 수 있는 것):
19
20	- 반복 드래프트: `.v1.html`, `-draft`, `-old`, `-copy`
21	- 빌드 스크립트가 산출물 옆에 남은 경우: `build.mjs`, `crop-*.mjs` (experiments 안이면 gitignore로 OK)
22	- 에이전트 로그 / 리뷰 덤프: `.orchestrator.log`, `.reviews/`
23	- 소스 크롭 / 컨택트 시트: `_source-`, `-contact-sheet*`
24
25	판단 기준: "이 파일이 6개월 뒤 처음 보는 기여자에게 의미가 있나?" No면 부산물.
26
27	### [2] scratch 디렉토리는 gitignore (절대 추적 X)
28
29	`.gitignore`에 다음이 있어야 한다 (이미 설정됨):
30
31	```
32	experiments/ # 갤러리 + 브랜드 목업 + 저니 (로컬 전용)
33	.promo/ # hyperframes 프로모 영상
34	.experiments/ # /omd-lab-* 런
35	.codex/ # codex 채널 self-install 산출물
36	.agents/skills/omd*/ # generic-agent 채널 self-install
37	web/.husky/ # root .husky의 중복본
38	```
39
40	새 채널/툴이 self-install 산출물을 만들면 같은 패턴으로 추가.
41
42	### [3] 문서 동기화 (deliverable 추가 시)
43
44	새 스킬/에이전트를 추가했으면 다음을 전부 갱신:
45
46	\| 위치 \| 무엇을 \|
47	\|---\|---\|
48	\| `README.md` \| 스킬 표 / 카운트. shipped vs local-preview 구분 명시 \|
49	\| `web/src/app/docs/page.tsx` \| `SKILLS` 또는 `V2_SKILLS` 배열 + 섹션 eyebrow 카운트 + 상단 nav anchor \|
50	\| `web/src/components/landing-v2/sections.tsx` \| "N skills + M sub-agents" 하드코딩 카운트 — 번들(npm) 기준으로만. local-preview는 카운트에서 제외 \|
51
52	홈 화면 카운트는 npm 번들 기준이다. local-preview 스킬을 더해도 홈 카운트는 안 올린다 (그게 일관성 신호).
53
54	### [4] npm 배포 판단 (shipped vs local-preview)
55
56	새 스킬/에이전트가 npm 패키지로 나갈지 결정한다. 두 갈래:
57
58	Shipped (번들) — 다음을 모두 해야 함:
59	1. `skills/<name>/SKILL.md`로 복사 (package source). `.claude/skills/`는 dogfood 미러.
60	2. 에이전트는 `agents/<name>.md`로 복사 (`agents/`는 통째로 ship).
61	3. `package.json`의 `files` 배열에 `skills/<name>` 추가 (files가 npm tarball을 gate).
62	4. 스킬이 의존하는 스크립트/데이터도 `files`에 포함 (예: `data/research/*.md`). 외부 스크립트 의존이 실효성 없으면 ship 전에 제거 (precedent: kr-spellcheck heuristic은 recall 낮아 폐기).
63	5. README/docs에서 "preview" 딱지 제거, 홈 카운트 +1.
64	6. 버전 bump: 기능 추가 = minor. 단, 버전 bump와 `npm publish`는 사용자 명시 요청 시에만.
65
66	Local-preview (dogfood만) — 기본값:
67	- `.claude/skills/` + `.claude/agents/`에만 존재. `skills/`·`files`에는 넣지 않음.
68	- README/docs에 "local preview, not bundled" 명시 + 수동 채택 방법(디렉토리 복사) 안내.
69	- 기존 local-only 선례: `omd-add-reference`, `omd-batch-launch`, `omd-migrate`, `omd-lab-*`.
70	- 기존 shipped 선례: v0.2 agent layer (orchestrator / kr-writer / locale-adapter / designer-review / final-qa / codex-image) — 6 skills + 6 agents.
71
72	판단 휴리스틱: 미완성 의존성(없는 스크립트 참조 등)·preview 성숙도·매 설치마다 footprint 증가가 걸리면 → local-preview. 안정적이고 자급자족이며 모든 채널에서 작동하면 → shipped 후보.
73
74	## 2. 실행 순서 (에이전트용)
75
76	```
77	1. bash scripts/check-release-hygiene.sh all # 부산물 전수 스캔
78	2. git status --porcelain \| grep -iE '_old\|_source\|\.bak\|v[0-9]\.\|contact-sheet' # 이중 확인
79	3. .gitignore에 scratch dir 누락 없는지 확인
80	4. 이번 changeset에 새 스킬/에이전트가 있나? → [3] 문서 동기화
81	5. 새 스킬을 ship할까? → [4] 판단. 기본 local-preview
82	6. 사용자에게 요약 보고. 커밋/푸시는 명시 요청 시에만.
83	```
84
85	## 3. 출력 형식
86
87	```
88	release-hygiene
89	[1] byproducts: ✓ 0 in changeset
90	[2] scratch dirs: ✓ experiments/ .promo/ .codex/ ignored
91	[3] docs sync: ✓ README + /docs updated (or: N/A — no new deliverable)
92	[4] npm decision: local-preview (joins omd-migrate et al.) (or: shipped → files updated)
93	```
94
95	## 4. 금지
96
97	- ❌ `experiments/` / `.promo/` 를 `git add -f`로 강제 추적
98	- ❌ 부산물 게이트를 `--no-verify`로 우회 (긴급시 외)
99	- ❌ 사용자 요청 없이 버전 bump 또는 `npm publish`
100	- ❌ local-preview 스킬을 홈 화면 번들 카운트에 합산
101	- ❌ shipped로 승격하면서 의존 스크립트를 `files`에 빠뜨림 (= 깨진 설치)
102
103	## 5. 관련
104
105	- `scripts/check-release-hygiene.sh` — 자동 부산물 게이트 (pre-commit)
106	- `.husky/pre-commit` — 게이트 + catalog-integrity 실행
107	- `package.json#files` — npm tarball allowlist (shipped 판단의 ground truth)

kwakseongjaePublisher · 49 listings

Preview

kwakseongjae/oh-my-design

# omd:release-hygiene

오픈소스 레포가 "최적의 결과물만 push"하도록 강제하는 루틴. 실험 과정에서 생긴 부산물이 public repo로 새는 것을 막고, 새 deliverable이 문서/패키징과 어긋나지 않게 한다.

자동 게이트는 [`scripts/check-release-hygiene.sh`](../../../scripts/check-release-hygiene.sh)가 husky `pre-commit`에서 돌린다. 이 스킬은 그 게이트가 잡지 못하는 *판단*(문서 동기화, npm 배포 여부)을

## 0. 언제 트리거하나

Repokwakseongjae/oh-my-design

LicenseMIT

TypeSkills

CategoryDesign

UpdatedJul 2026

Repo stars365

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

omd-release-hygiene

365stars35forks

View on GitHub

How to install omd-release-hygiene?

kwakseongjae/oh-my-design/omd-release-hygiene

$npx -y skills add kwakseongjae/oh-my-design --skill omd-release-hygiene

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# omd:release-hygiene
2
3	오픈소스 레포가 "최적의 결과물만 push"하도록 강제하는 루틴. 실험 과정에서 생긴 부산물이 public repo로 새는 것을 막고, 새 deliverable이 문서/패키징과 어긋나지 않게 한다.
4
5	자동 게이트는 [`scripts/check-release-hygiene.sh`](../../../scripts/check-release-hygiene.sh)가 husky `pre-commit`에서 돌린다. 이 스킬은 그 게이트가 잡지 못하는 판단(문서 동기화, npm 배포 여부)을 사람/에이전트가 책임지게 한다.
6
7	## 0. 언제 트리거하나
8
9	- 새 스킬 / 에이전트 / CLI 플래그 / 큰 기능을 추가한 직후
10	- 커밋 또는 push 직전 ("정리하고 올리자")
11	- 실험(`experiments/`, `.promo/`)을 돌린 세션의 마무리
12
13	## 1. 4-항목 체크리스트 (전부 통과해야 push)
14
15	### [1] 부산물 0건 (자동 + 수동)
16
17	자동: `bash scripts/check-release-hygiene.sh staged` — pre-commit이 이미 실행.
18	수동 확인 대상 (게이트 정규식 밖일 수 있는 것):
19
20	- 반복 드래프트: `.v1.html`, `-draft`, `-old`, `-copy`
21	- 빌드 스크립트가 산출물 옆에 남은 경우: `build.mjs`, `crop-*.mjs` (experiments 안이면 gitignore로 OK)
22	- 에이전트 로그 / 리뷰 덤프: `.orchestrator.log`, `.reviews/`
23	- 소스 크롭 / 컨택트 시트: `_source-`, `-contact-sheet*`
24
25	판단 기준: "이 파일이 6개월 뒤 처음 보는 기여자에게 의미가 있나?" No면 부산물.
26
27	### [2] scratch 디렉토리는 gitignore (절대 추적 X)
28
29	`.gitignore`에 다음이 있어야 한다 (이미 설정됨):
30
31	```
32	experiments/ # 갤러리 + 브랜드 목업 + 저니 (로컬 전용)
33	.promo/ # hyperframes 프로모 영상
34	.experiments/ # /omd-lab-* 런
35	.codex/ # codex 채널 self-install 산출물
36	.agents/skills/omd*/ # generic-agent 채널 self-install
37	web/.husky/ # root .husky의 중복본
38	```
39
40	새 채널/툴이 self-install 산출물을 만들면 같은 패턴으로 추가.
41
42	### [3] 문서 동기화 (deliverable 추가 시)
43
44	새 스킬/에이전트를 추가했으면 다음을 전부 갱신:
45
46	\| 위치 \| 무엇을 \|
47	\|---\|---\|
48	\| `README.md` \| 스킬 표 / 카운트. shipped vs local-preview 구분 명시 \|
49	\| `web/src/app/docs/page.tsx` \| `SKILLS` 또는 `V2_SKILLS` 배열 + 섹션 eyebrow 카운트 + 상단 nav anchor \|
50	\| `web/src/components/landing-v2/sections.tsx` \| "N skills + M sub-agents" 하드코딩 카운트 — 번들(npm) 기준으로만. local-preview는 카운트에서 제외 \|
51
52	홈 화면 카운트는 npm 번들 기준이다. local-preview 스킬을 더해도 홈 카운트는 안 올린다 (그게 일관성 신호).
53
54	### [4] npm 배포 판단 (shipped vs local-preview)
55
56	새 스킬/에이전트가 npm 패키지로 나갈지 결정한다. 두 갈래:
57
58	Shipped (번들) — 다음을 모두 해야 함:
59	1. `skills/<name>/SKILL.md`로 복사 (package source). `.claude/skills/`는 dogfood 미러.
60	2. 에이전트는 `agents/<name>.md`로 복사 (`agents/`는 통째로 ship).
61	3. `package.json`의 `files` 배열에 `skills/<name>` 추가 (files가 npm tarball을 gate).
62	4. 스킬이 의존하는 스크립트/데이터도 `files`에 포함 (예: `data/research/*.md`). 외부 스크립트 의존이 실효성 없으면 ship 전에 제거 (precedent: kr-spellcheck heuristic은 recall 낮아 폐기).
63	5. README/docs에서 "preview" 딱지 제거, 홈 카운트 +1.
64	6. 버전 bump: 기능 추가 = minor. 단, 버전 bump와 `npm publish`는 사용자 명시 요청 시에만.
65
66	Local-preview (dogfood만) — 기본값:
67	- `.claude/skills/` + `.claude/agents/`에만 존재. `skills/`·`files`에는 넣지 않음.
68	- README/docs에 "local preview, not bundled" 명시 + 수동 채택 방법(디렉토리 복사) 안내.
69	- 기존 local-only 선례: `omd-add-reference`, `omd-batch-launch`, `omd-migrate`, `omd-lab-*`.
70	- 기존 shipped 선례: v0.2 agent layer (orchestrator / kr-writer / locale-adapter / designer-review / final-qa / codex-image) — 6 skills + 6 agents.
71
72	판단 휴리스틱: 미완성 의존성(없는 스크립트 참조 등)·preview 성숙도·매 설치마다 footprint 증가가 걸리면 → local-preview. 안정적이고 자급자족이며 모든 채널에서 작동하면 → shipped 후보.
73
74	## 2. 실행 순서 (에이전트용)
75
76	```
77	1. bash scripts/check-release-hygiene.sh all # 부산물 전수 스캔
78	2. git status --porcelain \| grep -iE '_old\|_source\|\.bak\|v[0-9]\.\|contact-sheet' # 이중 확인
79	3. .gitignore에 scratch dir 누락 없는지 확인
80	4. 이번 changeset에 새 스킬/에이전트가 있나? → [3] 문서 동기화
81	5. 새 스킬을 ship할까? → [4] 판단. 기본 local-preview
82	6. 사용자에게 요약 보고. 커밋/푸시는 명시 요청 시에만.
83	```
84
85	## 3. 출력 형식
86
87	```
88	release-hygiene
89	[1] byproducts: ✓ 0 in changeset
90	[2] scratch dirs: ✓ experiments/ .promo/ .codex/ ignored
91	[3] docs sync: ✓ README + /docs updated (or: N/A — no new deliverable)
92	[4] npm decision: local-preview (joins omd-migrate et al.) (or: shipped → files updated)
93	```
94
95	## 4. 금지
96
97	- ❌ `experiments/` / `.promo/` 를 `git add -f`로 강제 추적
98	- ❌ 부산물 게이트를 `--no-verify`로 우회 (긴급시 외)
99	- ❌ 사용자 요청 없이 버전 bump 또는 `npm publish`
100	- ❌ local-preview 스킬을 홈 화면 번들 카운트에 합산
101	- ❌ shipped로 승격하면서 의존 스크립트를 `files`에 빠뜨림 (= 깨진 설치)
102
103	## 5. 관련
104
105	- `scripts/check-release-hygiene.sh` — 자동 부산물 게이트 (pre-commit)
106	- `.husky/pre-commit` — 게이트 + catalog-integrity 실행
107	- `package.json#files` — npm tarball allowlist (shipped 판단의 ground truth)

kwakseongjaePublisher · 49 listings

Preview

kwakseongjae/oh-my-design

# omd:release-hygiene

## 0. 언제 트리거하나

Repokwakseongjae/oh-my-design

LicenseMIT

TypeSkills

CategoryDesign

UpdatedJul 2026

Repo stars365

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type