# Archify 図解 (archify)

> 要件、Mermaid、リポジトリの根拠から、構成図や ERD など 10 種の検証済み単体 HTML 図や 1 ページ解説を作ります。

- カテゴリ: [アーキテクチャ改善](https://www.myskills.tools/ja/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 などの全体ルールファイルに 1 行書き込みます。

## 基本ルール

finalize がゼロ以外で終了したら決して成功とせず、失敗したゲートを直して再実行します。

## 実行フェーズ

1. **図の種類を選ぶ** — 質問に応じて 10 種のネイティブ図か解説ページかを選び、迷うときは guide コマンドを使います。
2. **スキーマと根拠** — 該当するスキーマ、例、既定ルールを読み、実在のコードベースならソースを根拠として追います。
3. **候補を書く** — .archify/ 配下の専用フォルダに、完全な candidate.json か解説ページの下書きを直接書きます。
4. **finalize 実行** — 検証、配信、厳格チェック、実ブラウザでのチェックを一度に実行し、失敗したらレシートを読んで直します。
5. **簡潔に報告** — HTML へのリンクから始め、読み方に影響する点だけを添え、コマンドやチェック一覧は省きます。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | 作業ディレクトリの .archify/ 配下に候補と HTML を書きます。ユーザーが同意した場合のみ全体ルールファイルに 1 行追加します。 |
| コマンド実行 | 一部で必要 | 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/ja/ · URL: https://www.myskills.tools/ja/skills/archify/