ALPS AIガイド
ALPS設計におけるAIの力
ALPS設計には、明確な状態定義、意味のある遷移、一貫した命名、標準語彙との整合性など、複数の要素のバランスが求められます。AIアシスタントはこのような多次元的な思考に優れています。
深いコンテキスト理解
AIはドメイン要件を分析し、本質的な状態と遷移を特定できます。「ショッピングカート付きのECシステム」と説明すると、AIは暗黙のフロー（閲覧 → カート → 決済 → 確認）を理解し、適切な状態名と遷移ラベルを提案します。
セマンティックな命名
命名には規約以上のもの—意図の理解が必要です。Linterはgo*やdo*のパターンを強制できますが、AIは何を意味するかとなぜ重要かを理解します。
「ユーザーが後で見るためにアイテムを保存できるようにする」と説明すると、AIはこれをウィッシュリストのパターンとして認識し、汎用的なdoSaveではなくSchema.orgのWantActionに沿ったdoAddToWishlistを提案します。author（創作的帰属）とcreator（技術的起源）を区別し、外部システムと意味的に接続できる語彙を確保します。
標準への準拠
AIは自動的にディスクリプタを確立された語彙と整合させます：
- Schema.orgの一般的な概念の定義
- IANAリンクリレーションの標準的な関係
- プロファイル全体で一貫した命名規則
統合方法
環境に合った方法を選択してください：
| 優先度 | 環境 | 方法 |
|---|---|---|
| 1st | Skillクライアント | Skill |
| 2nd | MCPクライアント | MCPサーバー |
| 3rd | その他のLLM | llms.txt |
Skill (Claude Code)
Claude Codeユーザー向けの推奨方法です。Skillはセッション全体でAIの動作をガイドする永続的なコンテキストを提供します。
セットアップ
claude --version # 2.0.0以上が必要
claude update # 必要に応じてアップデート
mkdir -p .claude/skills/alps
curl -o .claude/skills/alps/SKILL.md \
https://raw.githubusercontent.com/alps-asd/app-state-diagram/master/.claude/skills/alps/SKILL.md
確認
質問: 「利用可能なスキルは何ですか？」
レスポンスに「alps」スキルが含まれているはずです。
使用方法
- 「ブログシステムのALPSプロファイルを作成して」
- 「alps.xmlを検証して問題を修正して」
入力はテキスト、Figmaデザイン、OpenAPI仕様、ホワイトボード写真、WebサイトURL、その他データベーススキーマ、既存コード、GraphQLスキーマ、Postmanコレクション、Swaggerドキュメント、シーケンス図、ユーザーストーリー、ER図、JSONレスポンス、ルート定義、議事録、Slackスレッド、ナプキンスケッチ…が可能です。
Tip: コンソールでCtrl+Vを押すとクリップボードから画像を貼り付けられます。
MCPサーバー
Model Context ProtocolをサポートするAIクライアント向けです。MCPは検証とダイアグラム生成のためのリアルタイムツールアクセスを提供します。
セットアップ
まず、asdのパスを確認：
which asd # 例: /opt/homebrew/bin/asd
フルパスを使用してプロジェクトに.mcp.jsonを作成：
{
"mcpServers": {
"alps": {
"command": "/opt/homebrew/bin/asd",
"args": ["--mcp"]
}
}
}
確認: /mcpでリストに「alps」が表示されるはずです。
注意: MCPの接続はセッション中に切断されることがあります。/mcpを実行して再接続してください。
その他のMCPクライアント向け
MCPクライアント設定にasd --mcp（フルパス）をstdioサーバーとして追加してください。
利用可能なツール
| ツール | 説明 |
|---|---|
validate_alps |
ALPSプロファイルを検証し詳細なフィードバックを取得 |
alps2svg |
SVG状態ダイアグラムを生成 |
alps_guide |
ALPSベストプラクティスを取得 |
llms.txt (その他のLLM)
SkillやMCPをサポートしないLLM向けです。llms.txt標準は、どのアシスタントでも利用できるAIフレンドリーなドキュメントを提供します。
リソース
| リソース | 説明 |
|---|---|
| llms.txt | ALPS仕様インデックス |
| llms-full.txt | 完全なALPS仕様 |
| ALPS作成ガイド | 設計原則と例 |
システムプロンプト
システムプロンプトまたはAGENTS.mdに追加：
ALPSプロファイルの作成については、次を参照してください: https://raw.githubusercontent.com/alps-asd/app-state-diagram/master/.claude/skills/alps/SKILL.md
手動コピー
会話の最初に貼り付けるか、ファイルとしてアップロードしてください。
OpenAI GPTs
ALPSアシスタントは、ALPSに関する質問に特化してトレーニングされたカスタムGPTです。
注意: OpenAI Plusアカウントが必要です。
Google NotebookLM
ALPS Guide Notebookは、AIアシスタントと共にALPSの概念を探求できるインタラクティブなノートブックです。