MUSUBIX学習済み17ベストプラクティスガイド。コード・設計・テストパターンの適用に使用。
npx skills add https://github.com/nahisaho/MUSUBIX --skill musubix-best-practices이 명령을 Claude Code에 복사하여 붙여넣어 스킬을 설치하세요
| name | musubix-best-practices |
| description | MUSUBIX学習済み17ベストプラクティスガイド。コード・設計・テストパターンの適用に使用。 |
| license | MIT |
14以上のプロジェクトから学習した17のベストプラクティス。
| ID | パターン | 概要 |
|---|---|---|
| BP-CODE-001 | Entity Input DTO | 複数パラメータ→DTOオブジェクト |
| BP-CODE-002 | Date-based ID | PREFIX-YYYYMMDD-NNN形式 |
| BP-CODE-003 | Value Objects | ドメイン概念にVO使用 |
| BP-CODE-004 | Function-based VO | interface + factory関数（classは非推奨） |
| BP-CODE-005 | Result Type | Result<T, E>で失敗を表現 |
// ✅ 推奨
interface Price { readonly amount: number; readonly currency: 'JPY'; }
function createPrice(amount: number): Result<Price, ValidationError> {
if (amount < 100) return err(new ValidationError('...'));
return ok({ amount, currency: 'JPY' });
}
// ❌ 非推奨: class-based
| ID | パターン | 概要 |
|---|---|---|
| BP-DESIGN-001 | Status Transition Map | Record<Status, Status[]>で遷移定義 |
| BP-DESIGN-002 | Repository Async | 将来DB移行に備えてasync化 |
| BP-DESIGN-003 | Service Layer DI | リポジトリをDI |
| BP-DESIGN-004 | Optimistic Locking | versionフィールドで同時編集検出 |
| BP-DESIGN-005 | AuditService | データ変更の監査ログ |
| BP-DESIGN-006 | Entity Counter Reset | テスト用resetXxxCounter() |
| BP-DESIGN-007 | Expiry Time Logic | expiresAtで有効期限管理 |
const validTransitions: Record<Status, Status[]> = {
draft: ['active', 'cancelled'],
active: ['completed', 'cancelled'],
completed: [], cancelled: [],
};
| ID | パターン | 概要 |
|---|---|---|
| BP-TEST-001 | Counter Reset | beforeEachでIDカウンターリセット |
| BP-TEST-002 | Verify API | テスト前にAPIシグネチャ確認 |
| BP-TEST-003 | Vitest ESM | Vitest + TypeScript ESM構成 |
| BP-TEST-004 | Result Type Test | isOk()/isErr()で両ケーステスト |
| BP-TEST-005 | Status Transition | 有効・無効遷移を網羅テスト |
npx musubix learn best-practices # 全パターン表示
npx musubix learn best-practices --category code
npx musubix learn best-practices --high-confidence
┌────────────────────────────────────────────────┐
│ Best Practices Applied │
├────────────────────────────────────────────────┤
│ Code Patterns: 5 applied │
│ Design Patterns: 7 applied │
│ Test Patterns: 5 applied │
│ Confidence: 95% average │
└────────────────────────────────────────────────┘
Architecture Decision Records作成ガイド。技術選定・設計判断のドキュメント化に使用。
C4モデル設計ドキュメント作成ガイド。アーキテクチャ図・コンポーネント設計に使用。
設計仕様からコード生成ガイド。実装・機能作成に使用。
自動ドメイン検出・コンポーネント推論ガイド。プロジェクトドメイン特定に使用。
EARS形式要件の検証・作成ガイド。要件記述・構文検証に使用。
MUSUBIX SDD開発ワークフローガイド。10憲法条項に従った開発プロセスに使用。