nahisaho MUSUBIX C4 Design Skill
This skill guides you through creating C4 model architecture designs for MUSUBIX projects.
Overview
The C4 model provides four levels of abstraction for describing software architecture:
- Context - System boundaries and external actors
- Container - Technology choices and deployable units
- Component - Internal structure of containers
- Code - Implementation details (optional)
Prerequisites
Before creating designs:
- Read requirements from
storage/specs/(REQ-* files) - Check
steering/structure.ja.mdfor architecture guidelines - Review
steering/tech.ja.mdfor technology constraints
Design Document Template
# DES-[CATEGORY]-[NUMBER]: [Design Title]
## メタデータ
- **作成日**: YYYY-MM-DD
- **トレーサビリティ**: REQ-XXX-NNN
## 1. Context Level
### システムコンテキスト図
[External actors and systems that interact with our system]
### 外部アクター
| アクター | 説明 | インタラクション |
|---------|------|-----------------|
| User | システム利用者 | Web UI経由でアクセス |
## 2. Container Level
### コンテナ構成
| コンテナ | 技術 | 責務 |
|---------|------|------|
| Web App | React/Next.js | UI提供 |
| API Server | Node.js/Express | ビジネスロジック |
| Database | PostgreSQL | データ永続化 |
### コンテナ間通信
[Describe how containers communicate]
## 3. Component Level
### [Container Name] コンポーネント
| コンポーネント | 種別 | 責務 | 依存先 |
|---------------|------|------|--------|
| XxxService | Service | ビジネスロジック | XxxRepository |
| XxxRepository | Repository | データアクセス | Database |
| XxxController | Controller | リクエスト処理 | XxxService |
## 4. 設計パターン
### 適用パターン
| パターン | 適用箇所 | 理由 |
|---------|---------|------|
| Repository | データアクセス層 | 永続化の抽象化 |
| Service | ビジネス層 | ロジックの集約 |
| Factory | オブジェクト生成 | 生成ロジックの分離 |
## 5. 非機能要件への対応
### セキュリティ
- 認証: [方式]
- 認可: [方式]
- データ保護: [方式]
### スケーラビリティ
- [スケーリング戦略]
### 可用性
- [可用性設計]
C4 Diagram Syntax (Mermaid)
Context Diagram
flowchart TB
subgraph External["外部システム"]
User[ユーザー]
ExtAPI[外部API]
end
subgraph System["対象システム"]
App[アプリケーション]
end
User --> App
App --> ExtAPI
Container Diagram
flowchart TB
subgraph Containers["コンテナ構成"]
Web[Web App<br/>React]
API[API Server<br/>Node.js]
DB[(Database<br/>PostgreSQL)]
end
Web --> API
API --> DB
Component Diagram
flowchart TB
subgraph APIServer["API Server"]
Controller[Controller]
Service[Service]
Repository[Repository]
end
Controller --> Service
Service --> Repository
Design Patterns Reference
| パターン | 用途 | 適用場面 |
|---|---|---|
| Repository | データアクセス抽象化 | DB操作 |
| Service | ビジネスロジック集約 | ユースケース実装 |
| Factory | オブジェクト生成 | 複雑な生成ロジック |
| Strategy | アルゴリズム切替 | 認証方式、計算方式 |
| Observer | イベント通知 | 状態変更の伝播 |
| Decorator | 機能追加 | ログ、キャッシュ |
Domain-Specific Components
Use npx musubix design generate to get domain-specific component recommendations for 62 domains.
Output Location
Save design documents to:
storage/design/DES-[CATEGORY]-[NUMBER].md
Related Skills
musubix-ears-validation- Requirements validationmusubix-code-generation- Generate code from designmusubix-adr-generation- Document architecture decisions