# Archify 다이어그램 (archify)

> 요구사항, Mermaid, 저장소 근거로 아키텍처·ERD 등 10종의 검증된 단독 HTML 다이어그램이나 한 페이지 설명을 만듭니다.

- 카테고리: [아키텍처 개선](https://www.myskills.tools/ko/categories/architecture-tuning/)
- 출처: 커뮤니티 · tt-a1i
- 저장소: https://github.com/tt-a1i/archify/tree/main/archify (commit edf158c · v3.2)
- SKILL.md: https://github.com/tt-a1i/archify/blob/main/archify/SKILL.md
- 설치 명령: `npx skills add tt-a1i/archify --skill archify`
- 라이선스: Apache-2.0
- 호환 도구: Claude Code, Codex, Cursor, OpenCode
- 권한: read-repo ✓, write-files ✓, shell ✓, network ✓
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.
- ⚠ 사용자가 능동 모드를 수락하면 ~/.claude/CLAUDE.md 같은 전역 규칙 파일에 한 줄을 추가합니다.

## 핵심 규칙

finalize가 0이 아닌 코드로 끝나면 절대 성공이 아니며, 실패한 게이트를 고친 뒤 다시 실행합니다.

## 실행 단계

1. **유형 선택** — 질문에 맞춰 10종의 기본 다이어그램이나 설명 페이지를 고르고, 애매하면 guide 명령을 씁니다.
2. **스키마·근거 확인** — 해당 스키마, 예제, 기본 규칙을 읽고, 실제 코드베이스라면 소스를 근거로 추적합니다.
3. **후보 파일 작성** — .archify/ 아래 전용 폴더에 완성된 candidate.json이나 설명 페이지 초안을 바로 작성합니다.
4. **finalize 실행** — 검증, 전달, 엄격 검사, 실제 브라우저 검사를 한 번에 실행하고, 실패하면 영수증을 읽고 고쳐 다시 실행합니다.
5. **간단히 전달** — HTML 링크로 시작하고 읽는 방식에 영향을 주는 점만 덧붙이며, 명령이나 검사 목록은 생략합니다.

## 권한 설명 (SKILL.md 기준)

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 일부 필요 | 작업 디렉터리의 .archify/ 하위 폴더에 후보와 HTML을 씁니다. 사용자가 동의하면 전역 규칙 파일에 한 줄을 추가합니다. |
| 명령 실행 | 일부 필요 | node bin/archify.mjs의 finalize, guide, doctor 등 하위 명령을 실행하며 실제 브라우저 검사도 포함됩니다. |
| 네트워크 송신 | 일부 필요 | finalize가 제한된 업데이트 확인을 하며, 사용자가 URL을 준 미지의 브랜드 로고만 가져옵니다. 업데이트는 자동 설치하지 않습니다. |

## SKILL.md 프런트매터(YAML)

```yaml
---
name: archify
description: "Create validated architecture, workflow, sequence, data-flow, lifecycle/state, ERD, class, tree, timeline, and waterfall diagrams as explorable standalone HTML with dark/light themes, motion and image/SVG/WebM export. Accept requirements or Mermaid; inspect repository evidence for code-backed diagrams. Use when visualizing systems, API calls, pipelines, schemas, histories, timings, or everyday steps, parts, relationships and states. Also turn an answer into a one-page explainer, with the conclusion first, structured panels, native diagrams and charts, when the user asks for a page, an explainer or an answer to share (做成一页, 用页面讲), or proactively when the user's rules opt in with an [archify explainer: ...] line. Not for dashboards."
license: Apache-2.0
metadata:
  version: "3.2"
  author: tt-a1i
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/archify/