likec4-architecture について
LikeC4 のソフトウェアアーキテクチャモデルを作成・保守するワークフロースキルです。モデル構造とビューを整理し、CLI による検証、プレビューやエクスポートまでを支援します。
主な機能
- 01モデルファイルの再利用と初期化
- 02要素と関係の定義
- 03目的に沿ったビューの作成
- 04LikeC4 CLI によるモデル検証
- 05プレビューとエクスポートのコマンド提示
活用シーン
- 01システムのアーキテクチャモデル作成
- 02ドメインやチーム別の図の整理
- 03共有前のアーキテクチャ変更の検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/likec4-architectureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlassets/likec4-starter/docs/architecture/model.c4evaluations/create-new-model.jsonexport-artifacts.jsonupdate-existing-model.jsonreferences/examples.mdlikec4-capabilities-reference.mdlikec4-checklist.mdlikec4-dsl-quickstart.mdlikec4-patterns.mdscripts/bootstrap_likec4_starter.sh詳細
LikeC4 アーキテクチャ
LikeC4 でソフトウェアアーキテクチャをモデル化し、実行可能な状態に保ち、検証済みの出力を返します。
ワークフロー
- モデルの範囲を定めます。
- システム境界と対象ユーザーを特定します。
- ユーザーから別の指定がない限り、コンテキストビューとコンテナビューから始めます。
- モデルファイルを探します。
- 既存の
.c4／.likec4ファイルがあれば再利用します。 - 見つからない場合は、
assets/likec4-starter/docs/architecture/model.c4を基に初期設定します。
- ビジュアルより先に構造をモデル化します。
- 安定した要素 ID と意味のある名前を定義します。
- 短いラベルを付けた、方向が明確な関係を追加します。
- 必要に応じて、テクノロジーや説明のフィールドを追加します。
- ビューの焦点を絞ります。
- 小さく、目的の明確なビューを作成します。
- 図が込み入ってきたら、ドメイン、チーム、または境界づけられたコンテキストごとに分割します。
- 検証してパッケージ化します。
npx likec4 validateを実行し、すべてのエラーを修正します。- プレビュー用の
npx likec4 startコマンドを提示します。 - 要望があれば、
build／exportコマンドも提示します。
必須の品質ゲート
- ラベルがなく曖昧な関係を残さないでください。
- どのビューにも登場しない孤立した要素を残さないでください。
- 要素のタイトルには、実装上の詳細よりドメイン名を優先してください。
- CLI による検証に成功してから完了してください。
コマンドセット
タスクに必要な最小限のコマンドを使用します。
npx likec4 validate
npx likec4 start
npx likec4 build -o ./dist
npx likec4 export png -o ./assets/architecture
出力要件
アーキテクチャファイルを変更した場合は、以下を返します。
- 変更したファイル。
- 検証結果。
- 各ビューの目的を一行で説明したもの。
- 要望に関連するプレビュー／ビルド／エクスポートのコマンド。
リソース
- CLI とモデリングのチェックリスト：
references/likec4-checklist.md - スターターモデルのテンプレート：
assets/likec4-starter/docs/architecture/model.c4 - 初期設定用ヘルパー：
scripts/bootstrap_likec4_starter.sh
コメント
Markdown 対応