archifycommit edf158c · v3.2SKILL.md · アーキテクチャ改善
Archify 図解
要件、Mermaid、リポジトリの根拠から、構成図や ERD など 10 種の検証済み単体 HTML 図や 1 ページ解説を作ります。
ユーザーが能動モードを承諾すると、~/.claude/CLAUDE.md などの全体ルールファイルに 1 行書き込みます。
npx skills add tt-a1i/archify --skill archifyコマンドを選択しました。手動でコピーしてください。
- 権限
- read-repo
- write-files
- shell
- network
- 対応ツール
- Claude Code, Codex, Cursor, OpenCode
- GitHub
- 92.2k
- 提供元
- コミュニティ · tt-a1i
- 状態
- スキャン済み
- ライセンス
- Apache-2.0
- カテゴリ
- アーキテクチャ改善
基本ルール
finalize がゼロ以外で終了したら決して成功とせず、失敗したゲートを直して再実行します。
実行フェーズ
フェーズ 01図の種類を選ぶ
質問に応じて 10 種のネイティブ図か解説ページかを選び、迷うときは guide コマンドを使います。
フェーズ 02スキーマと根拠
該当するスキーマ、例、既定ルールを読み、実在のコードベースならソースを根拠として追います。
フェーズ 03候補を書く
.archify/ 配下の専用フォルダに、完全な candidate.json か解説ページの下書きを直接書きます。
フェーズ 04finalize 実行
検証、配信、厳格チェック、実ブラウザでのチェックを一度に実行し、失敗したらレシートを読んで直します。
フェーズ 05簡潔に報告
HTML へのリンクから始め、読み方に影響する点だけを添え、コマンドやチェック一覧は省きます。
権限の説明（SKILL.md より）
| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | 作業ディレクトリの .archify/ 配下に候補と HTML を書きます。ユーザーが同意した場合のみ全体ルールファイルに 1 行追加します。 |
| コマンド実行 | 一部で必要 | node bin/archify.mjs の finalize、guide、doctor などのサブコマンドを実行し、実ブラウザでのチェックも含みます。 |
| 外部通信 | 一部で必要 | finalize は限定的な更新チェックを行い、ユーザーが URL を示した未知のブランドロゴのみ取得します。更新は自動で入れません。 |
SKILL.md のフロントマター（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
---関連スキル
ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。