Michi - AI-driven Spec-Driven Development workflow for Claude Code

version
1.6.0

Install

/plugin install michi@sk8metalme-michi

Run it inside Claude Code after adding the marketplace with /plugin marketplace add sk8metalme/michi.

Contents

Discovered from source

Skills 20

analyze-gap: Gap分析

Gap分析スキルは、既存コードベースと新規実装の差分を分析し、統合ポイントを特定します。

概要

このスキルは以下を実行します:

  1. 既存コードベース分析:
    • 既存のアーキテクチャを把握
    • 既存のAPI・データモデルを確認
  2. 新規実装との差分分析:
    • 新規実装が既存コードとどのように統合されるか
    • 競合する部分を特定
  3. 統合ポイント特定:
    • インターフェースの統合ポイント
    • データモデルの統合ポイント
    • ワークフローの統合ポイント
  4. 実装戦略提案:
    • 段階的な統合戦略
    • リスク回避策
    • ロールバック計画
  5. Gap分析レポート: 分析結果と実装戦略を記載

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「Gap分析したい」
  • 「既存コードとの統合を分析」
  • 既存システムへの新機能追加時に自動提案

明示的発動

/michi analyze-gap {pj-name}

例:

/michi analyze-gap user-auth

サブエージェント活用(並列探索)

既存コードベースの探索を3つのExploreエージェントで並列実行します:

Phase 1: 並列コードベース探索

エージェント対象目的出力
アーキテクチャ探索src/, lib/, packages/レイヤー構造、設計パターン特定アーキテクチャ構造レポート
API探索routes/, controllers/, api/既存APIエンドポイント一覧API仕様リスト
データモデル探索models/, entities/, migrations/DBスキーマ、リレーションデータモデルリスト

Phase 2: 統合分析(メインエージェント)

  • Phase 1の結果を統合
  • 新規実装との差分を分析
  • Gap分析レポート生成

メリット:

  • コードベース探索を大幅に高速化(並列実行により)
  • 複数の観点から並行して分析
  • 各エージェントが独立して動作し、結果を統合

実行内容

1. 既存コードベース分析

既存アーキテクチャの把握:

  • レイヤー構造
  • 使用技術スタック
  • 設計パターン

既存API・データモデルの確認:

  • REST API エンドポイント一覧
  • データベーススキーマ
  • 外部サービス連携

2. 新規実装との差分分析

新規実装の影響範囲:

  • 新規追加されるAPI
  • 新規追加されるテーブル
  • 既存APIの変更

競合する部分を特定:

  • 既存のユーザー認証と新規実装の認証
  • 既存のデータモデルと新規実装のデータモデル
  • 既存のワークフローと新規実装のワークフロー

3. 統合ポイント特定

インターフェースの統合ポイント:

  • API Gateway との統合
  • フロントエンドとの統合
  • 外部サービスとの統合

データモデルの統合ポイント:

  • 既存テーブルとの外部キー
  • 共有されるマスターデータ
  • データ移行が必要な部分

ワークフローの統合ポイント:

  • 既存の処理フローに新機能を組み込む
  • イベント駆動の統合

4. 実装戦略提案

段階的な統合戦略:

  1. Phase 1: 独立した機能として実装(既存コードに影響なし)
  2. Phase 2: API統合(新規APIを既存フロントエンドから呼び出し)
  3. Phase 3: データ統合(既存データと新規データを連携)
  4. Phase 4: ワークフロー統合(既存処理フローに組み込み)

リスク回避策:

  • Feature Flagを使用して段階的にロールアウト
  • Blue-Green Deployment で切り替え
  • カナリアリリースで段階的に展開

ロールバック計画:

  • データベース変更のロールバックスクリプト
  • Feature Flagでの機能無効化
  • 以前のバージョンへのデプロイ手順

5. Gap分析レポート

分析結果を以下の形式でレポートします:

# Gap分析レポート: {pj-name}

## 既存コードベース

### アーキテクチャ
- Monolithic Architecture
- Backend: Node.js + Express
- Frontend: React + Redux
- Database: PostgreSQL

### 既存API
- POST /api/session - セッション管理
- GET /api/profile - プロフィール取得

### 既存データモデル
- sessions テーブル
- profiles テーブル

## 新規実装との差分

### 新規追加
- POST /api/users - ユーザー登録
- POST /api/login - ログイン
- users テーブル

### 既存APIの変更
- なし

### 競合箇所
- 既存の sessions テーブルと新規の users テーブルの連携

## 統合ポイント

### インターフェース統合
- API Gateway: 既存エンドポイントと新規エンドポイントを統合
- フロントエンド: ログインページから新規ログインAPIを呼び出し

### データモデル統合
- sessions.user_id → users.id の外部キー追加

### ワークフロー統合
- 既存のセッション管理に新規のユーザー認証を組み込み

## 実装戦略

### Phase 1: 独立実装
- users テーブル作成
- POST /api/users, POST /api/login 実装
- 既存コードに影響なし

### Phase 2: API統合
- フロントエンドから新規ログインAPIを呼び出し
- Feature Flag で新旧ログインを切り替え

### Phase 3: データ統合
- sessions.user_id → users.id の外部キー追加
- 既存セッションデータを移行

### Phase 4: ワークフロー統合
- 既存のセッション管理に新規ユーザー認証を完全統合
- 旧ログインAPIを廃止

## リスク回避策

- Feature Flag: `use_new_auth` で新旧切り替え
- Blue-Green Deployment: 問題発生時は即座に切り戻し
- カナリアリリース: 5% → 25% → 50% → 100%

## ロールバック計画

1. Feature Flag で旧ログインに切り戻し
2. 外部キー制約を削除
3. 新規テーブルをドロップ(必要に応じて)

次のステップ

Gap分析が完了したら、次のステップに進みます:

統合戦略に基づいてタスクを分割

/michi create-tasks {pj-name}

段階的に実装

Phase 1から順番に実装し、各Phaseごとに検証します。

/michi dev {pj-name}

参照

  • アーキテクチャガイド: docs/master-docs/structure.md
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • create-tasks - タスク分割(統合戦略に基づく)
  • dev - TDD実装(段階的に実装)

archive-pj: プロジェクトアーカイブ

プロジェクトアーカイブスキルは、完了したプロジェクトをアーカイブに移動し、作業ディレクトリをクリーンに保ちます。

概要

このスキルは以下を実行します:

  1. 完了確認: プロジェクトが完了しているか確認
  2. メタデータ移動: .michi/pj/YYYYMMDD-{pj-name}/ を .michi/archive-pj/{pj-name}-{timestamp}/ に移動
  3. 仕様書保持: docs/michi/YYYYMMDD-{pj-name}/ は Git で管理されたまま保持
  4. アーカイブ記録: アーカイブ日時をメタデータに記録

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「プロジェクトをアーカイブしたい」
  • 「完了したのでアーカイブ」
  • project.json の phase: "implementation-complete" の場合

明示的発動

/michi archive-pj {pj-name}

例:

/michi archive-pj user-auth

実行内容

1. 完了確認

以下を確認します:

  • プロジェクトのフェーズが implementation-complete または手動アーカイブ許可
  • すべてのタスクが完了している
  • テストが合格している

2. メタデータ移動

以下のディレクトリを移動します:

移動前:
.michi/pj/YYYYMMDD-{pj-name}/

移動後:
.michi/archive-pj/{pj-name}-{timestamp}/

timestamp: アーカイブ日時(例: 20260117-150000)

3. メタデータ更新

project.json に以下を追加:

{
  "archivedAt": "2026-01-17T15:00:00Z",
  "archivedBy": "claude-code"
}

4. 仕様書は保持

仕様書(docs/michi/YYYYMMDD-{pj-name}/)は Git で管理されたまま保持されます。 これにより、過去のプロジェクトを参照できます。

次のステップ

アーカイブ後、新しいプロジェクトを開始できます:

/michi launch-pj "新しいプロジェクト説明"

アーカイブ解除

アーカイブされたプロジェクトを復元する場合:

# 手動で .michi/archive-pj/ から .michi/pj/ に移動
mv .michi/archive-pj/{pj-name}-{timestamp} .michi/pj/YYYYMMDD-{pj-name}

参照

  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • show-status - ステータス表示(アーカイブ前に確認)
  • launch-pj - 新規プロジェクト初期化(アーカイブ後に実行)
  • switch-pj - プロジェクト切り替え

create-design: 設計書作成

設計書作成スキルは、C4モデルによるアーキテクチャ設計、シーケンス図、データモデルを生成します。

概要

このスキルは以下を実行します:

  1. 要件定義参照: requirements.md を読み込んで要件を把握
  2. C4モデル設計: Context, Container, Component, Code の4レベルで設計
  3. シーケンス図作成: 主要な処理フローをシーケンス図で表現
  4. データモデル設計: エンティティ、属性、リレーションを定義
  5. 設計書生成:
    • docs/michi/YYYYMMDD-{pj-name}/spec/architecture.md
    • docs/michi/YYYYMMDD-{pj-name}/spec/sequence.md
    • docs/michi/YYYYMMDD-{pj-name}/spec/design.md
  6. フェーズ更新: project.json のフェーズを design-generated に更新

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「設計書を作成したい」
  • 「アーキテクチャを設計」
  • project.json の phase: "requirements-generated" の場合

明示的発動

/michi create-design {pj-name}

例:

/michi create-design user-auth

実行内容

1. 要件定義参照

docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md を読み込んで要件を把握します。

2. C4モデル設計

C4モデルの4レベルで設計を行います:

Level 1: Context(コンテキスト図)

  • システムの境界を定義
  • 外部システムとの関係を明示

Level 2: Container(コンテナ図)

  • アプリケーション、データベース、サービスを定義
  • コンテナ間の通信を明示

Level 3: Component(コンポーネント図)

  • 各コンテナ内のコンポーネントを定義
  • コンポーネント間の依存関係を明示

Level 4: Code(コード図)

  • クラス構造を定義
  • 主要なインターフェースを明示

3. シーケンス図作成

主要な処理フローをMermaidシーケンス図で表現します:

sequenceDiagram
    participant User
    participant API
    participant Auth
    participant DB

    User->>API: POST /login
    API->>Auth: authenticate(credentials)
    Auth->>DB: findUser(email)
    DB-->>Auth: user
    Auth-->>API: token
    API-->>User: 200 OK (token)

4. データモデル設計

エンティティ、属性、リレーションを定義します:

## エンティティ

### User
- id: UUID (PK)
- email: String (Unique)
- passwordHash: String
- createdAt: DateTime
- updatedAt: DateTime

### Session
- id: UUID (PK)
- userId: UUID (FK -> User.id)
- token: String (Unique)
- expiresAt: DateTime

5. 設計書生成

以下のファイルを作成します:

  1. architecture.md: C4モデルによるアーキテクチャ設計
  2. sequence.md: シーケンス図
  3. design.md: 詳細設計(データモデル、API仕様、エラーハンドリングなど)

6. フェーズ更新

project.json のフェーズを更新します:

{
  "phase": "design-generated",
  "updatedAt": "2026-01-17T00:00:00Z"
}

7. TODO抽出の自動提案

設計書生成後、Claude は自動的に TODO 抽出を提案します:

設計書を生成しました。

設計上のリスクや不明点を TODO として管理しますか?
  - manage-todos scan {pj-name} を実行

ユーザーが同意した場合、manage-todos scan を実行して、設計書から TODO を抽出します。

次のステップ

設計が完了したら、次のステップに進みます:

推奨: TODO抽出

設計書からリスクや不明点を抽出してTODO管理を更新します。

manage-todos スキルを使用してTODOを抽出します:

/michi manage-todos scan {pj-name}

または自動発動:

TODOを確認したい

抽出対象:

  • 設計上のリスク(Risk)
  • 技術選定の仮定(Assumption)
  • 詳細設計の不明点(Question)
  • 技術的負債(Tech Debt)

オプション1: テスト計画

plan-tests スキルを使用してテスト計画を作成します。

/michi plan-tests {pj-name}

オプション2: タスク分割

create-tasks スキルを使用してタスクに分割します。

/michi create-tasks {pj-name}

参照


次のスキル:

  • plan-tests - テスト計画作成
  • create-tasks - タスク分割

create-requirements: 要件定義書作成

要件定義書作成スキルは、EARS形式の要件定義を生成し、プロジェクトの要件を明確化します。

概要

このスキルは以下を実行します:

  1. ultrathink自動有効化: 深い分析のためにultrathinkモードを有効化
  2. マスタードキュメント参照: プロジェクト横断の共通知識と整合を取る
  3. EARS形式要件定義: Easy Approach to Requirements Syntax 形式で要件を記述
  4. 要件定義書生成: docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md を作成
  5. フェーズ更新: project.json のフェーズを requirements-generated に更新

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「要件定義したい」
  • 「要件を作成」
  • project.json の phase: "initialized" の場合

明示的発動

/michi create-requirements {pj-name}

例:

/michi create-requirements user-auth

実行内容

1. ultrathink自動有効化

深い分析のため、ultrathinkモードを自動的に有効化します。

2. マスタードキュメント参照

以下のマスタードキュメントを参照して、プロジェクト横断の整合性を確保します:

  • docs/master-docs/structure.md - システム構造
  • docs/master-docs/tech.md - 技術スタック
  • docs/master-docs/product.md - プロダクト要件

3. EARS形式要件定義

EARS(Easy Approach to Requirements Syntax)形式で要件を記述します:

EARS形式のテンプレート:

  • Ubiquitous: システムは常に〜すること
  • Event-driven: 〜の場合、システムは〜すること
  • State-driven: 〜の状態において、システムは〜すること
  • Optional: 必要に応じて、システムは〜してもよい
  • Unwanted: 〜の場合、システムは〜してはならない

4. 要件定義書生成

docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md を作成します:

# 要件定義書: {pj-name}

## プロジェクト概要
...

## 機能要件
### FR-001: ...
- **種類**: Ubiquitous
- **要件**: システムは常に〜すること
- **優先度**: 高
- **受入条件**: ...

### FR-002: ...
...

## 非機能要件
### NFR-001: パフォーマンス
...

### NFR-002: セキュリティ
...

## 制約条件
...

## 参照
- マスタードキュメント: docs/master-docs/

5. フェーズ更新

project.json のフェーズを更新します:

{
  "phase": "requirements-generated",
  "updatedAt": "2026-01-17T00:00:00Z"
}

6. TODO抽出の自動提案

要件定義書生成後、Claude は自動的に TODO 抽出を提案します:

要件定義書を生成しました。

不明点や仮定を TODO として管理しますか?
  - manage-todos scan {pj-name} を実行

ユーザーが同意した場合、manage-todos scan を実行して、要件定義書から TODO を抽出します。

次のステップ

要件定義が完了したら、次のステップに進みます:

推奨: TODO抽出

要件定義書から不明点や仮定を抽出してTODO管理を開始します。

manage-todos スキルを使用してTODOを抽出します:

/michi manage-todos scan {pj-name}

または自動発動:

TODOを確認したい

抽出対象:

  • 「前提条件」セクションの仮定(Assumption)
  • 「制約事項」セクションの不明点(Question)

推奨: 設計書作成

create-design スキルを使用して設計書を作成します。

/michi create-design {pj-name}

または自動発動:

設計書を作成したい

参照

  • EARS形式ガイドライン: ~/.michi/settings/rules/ears-format.md
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

次のスキル: create-design - 設計書作成

create-tasks: タスク分割

タスク分割スキルは、設計を実装可能なタスクに分割し、依存関係をマッピングします。

概要

このスキルは以下を実行します:

  1. 設計書参照: design.md, architecture.md, test-plan を読み込んで設計を把握
  2. タスク分割: 1-3日単位のタスクに分割
  3. 依存関係マッピング: タスク間の依存関係を明示
  4. 優先度設定: タスクの優先度を設定
  5. タスク一覧生成: docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.md を作成
  6. フェーズ更新: project.json のフェーズを tasks-generated に更新

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「タスクに分割したい」
  • 「タスク一覧を作成」
  • project.json の phase: "design-generated" または test-plan-generated の場合に自動提案

明示的発動

/michi create-tasks {pj-name}

例:

/michi create-tasks user-auth

サブエージェント活用(Plan + Explore)

タスク分割をPlanエージェントで実行し、設計書読み込みをExploreエージェントに委譲します:

Phase 1: 設計書収集(Explore x 2)

エージェント対象出力
設計書収集design.md, architecture.md設計サマリー
テスト計画収集test-plan/strategy.mdテスト戦略サマリー

Phase 2: タスク分割分析(Plan)

Planエージェントで以下を分析:

  • タスクの粒度(1-3日単位)
  • 依存関係のトポロジカルソート
  • 優先度設定

Phase 3: ファイル生成(メインエージェント)

  • tasks.md生成
  • project.json更新

Planエージェント活用のメリット:

  • タスク分割に特化した分析
  • 依存関係の正確なマッピング
  • 実装順序の最適化

Exploreエージェント活用のメリット:

  • 設計書の高速読み込み
  • コンテキスト収集の効率化

実行内容

1. 設計書参照

以下のファイルを読み込んで設計を把握します:

  • docs/michi/YYYYMMDD-{pj-name}/spec/design.md
  • docs/michi/YYYYMMDD-{pj-name}/spec/architecture.md
  • docs/michi/YYYYMMDD-{pj-name}/test-plan/strategy.md

2. タスク分割

1-3日単位のタスクに分割します:

分割原則:

  • 粒度: 1タスクは1-3日で完了できる規模
  • 独立性: 可能な限り独立して実装できるタスク
  • テスト駆動: 各タスクには対応するテストが含まれる
  • コードサイズ: 1タスクあたり最大500行の変更(推奨)

3. 依存関係マッピング

タスク間の依存関係を明示します:

## タスク一覧

### TASK-001: データベーススキーマ作成
- **説明**: User テーブルを作成
- **依存**: なし
- **優先度**: 高
- **見積もり**: 1日

### TASK-002: ユーザー登録API実装
- **説明**: POST /api/users エンドポイントを実装
- **依存**: TASK-001
- **優先度**: 高
- **見積もり**: 2日

### TASK-003: ログインAPI実装
- **説明**: POST /api/login エンドポイントを実装
- **依存**: TASK-001, TASK-002
- **優先度**: 高
- **見積もり**: 2日

4. タスク一覧生成

docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.md を作成します:

# タスク一覧: {pj-name}

## プロジェクト概要
...

## タスク依存関係図

```mermaid
graph TD
    TASK001[TASK-001: DB Schema]
    TASK002[TASK-002: User Registration API]
    TASK003[TASK-003: Login API]
    TASK004[TASK-004: E2E Test]

    TASK001 --> TASK002
    TASK001 --> TASK003
    TASK002 --> TASK004
    TASK003 --> TASK004

タスク一覧

Phase 1: データベース

  • TASK-001: データベーススキーマ作成

Phase 2: API実装

  • TASK-002: ユーザー登録API実装
  • TASK-003: ログインAPI実装

Phase 3: テスト

  • TASK-004: E2Eテスト実装

### 5. フェーズ更新

project.json のフェーズを更新します:

```json
{
  "phase": "tasks-generated",
  "updatedAt": "2026-01-17T00:00:00Z"
}

次のステップ

タスク分割が完了したら、次のステップに進みます:

推奨: TDD実装

dev スキルを使用してTDD実装を開始します。

/michi dev {pj-name}

または自動発動:

実装したい

参照

  • コードサイズガイドライン: ../../rules/code-size-rules.md
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

次のスキル: dev - TDD実装 + 品質自動化

dev: TDD実装 + 品質自動化

TDD実装 + 品質自動化スキルは、テスト駆動開発(Red-Green-Refactor)サイクルで実装を行い、包括的な品質管理を実施します。

概要

このスキルは以下のフェーズを自動実行します:

Phase 6.1: 実装準備

  1. タスク一覧を確認
  2. TODO状況確認(高優先度TODOの警告表示)
  3. ブランチ作成(feature/{pj-name})
  4. 実装対象タスクを選択

Phase 6.2: 事前品質監査

  1. OSS License Check(oss-license-checker エージェント)
  2. Version Audit(stable-version-auditor エージェント)
  3. 問題検出時は修正を実行

Phase 6.3: TDD実装(Red-Green-Refactor)

  1. Red: テストを先に書く(失敗することを確認)
  2. Green: 最小限の実装でテストを通す
  3. Refactor: コードを整理・改善
  4. 1タスクあたり最大500行の変更を推奨

Phase 6.4: 自動修正ループ(最大5回)

  1. テスト実行
  2. 失敗時は自動修正を試行
  3. 最大5回までループ
  4. 5回失敗時はユーザーに報告

Phase 6.5: カバレッジ検証

  1. テストカバレッジを測定
  2. 95%以上を目標
  3. 不足時は追加テストを作成

Phase 6.6: Mutation Testing(オプション)

  1. Stryker / PIT を使用
  2. Mutation Score 80%以上を目標

Phase 6.7: 事後品質レビュー

  1. Code Review(code-review エージェント)
  2. Design Review(design-review エージェント)
  3. 問題検出時は修正を実行

Phase 6.8: コミット・PR作成

  1. git add / git commit
  2. gh pr create
  3. CI/CD実行確認

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「実装したい」
  • 「TDDで実装」
  • project.json の phase: "tasks-generated" の場合に自動提案

明示的発動

/michi dev {pj-name}

例:

/michi dev user-auth

実行内容

Phase 6.1: 実装準備

  1. タスク一覧確認:

    • docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.md を読み込み
    • 未完了タスクを表示
  2. TODO状況確認:

    • docs/michi/YYYYMMDD-{pj-name}/todos/todos.md を読み込み
    • 未解決の高優先度TODOがある場合は警告表示
    ⚠️ 警告: 未解決の高優先度TODOがあります
    
    TODO-Q-001: 認証トークンの有効期限は何分にすべきか?
    
    実装を続行しますか?
    ```text
    - ユーザーが続行を選択した場合のみ次に進む
    
    
  3. タスク選択:

    • ユーザーに実装するタスクを選択させる
    • 依存関係を確認
  4. ブランチ作成:

    git checkout -b feature/{pj-name}/{task-id}
    

Phase 6.2: 事前品質監査

サブエージェント活用(Bashエージェント並行実行):

品質監査を複数のBashエージェントで並行実行します:

エージェントタイプコマンド目的
ライセンスチェックBashnpx license-checker --summaryOSS License 監査
バージョン監査Bashnpm outdated --jsonEOL/非推奨バージョン検出
依存脆弱性Bashnpm audit --json既知脆弱性チェック

→ Critical検出時は即時停止

実行内容:

  1. OSS License Check:

    • npx license-checker --summary を実行
    • 違反ライセンスを検出
    • 代替パッケージを提案
  2. Version Audit:

    • npm outdated --json を実行
    • EOLバージョンを検出
    • アップグレードを提案
  3. 問題修正:

    • 検出された問題を自動修正
    • 修正不可能な場合はユーザーに報告

メリット:

  • 複数のnpmコマンドを並行実行
  • 品質チェックの待ち時間を大幅短縮
  • 各コマンドの結果を独立して評価

Phase 6.3: TDD実装

Red-Green-Refactor サイクル:

  1. Red(失敗するテストを書く):

    describe('User Registration', () => {
      it('should create a new user', async () => {
        const result = await createUser({
          email: 'test@example.com',
          password: 'password123'
        });
        expect(result).toBeDefined();
        expect(result.id).toBeDefined();
      });
    });
    
  2. Green(最小限の実装):

    async function createUser(data: CreateUserInput): Promise<User> {
      // 最小限の実装
      const user = await db.users.create(data);
      return user;
    }
    
  3. Refactor(コード整理):

    async function createUser(data: CreateUserInput): Promise<User> {
      // バリデーション追加
      validateEmail(data.email);
      validatePassword(data.password);
    
      // パスワードハッシュ化
      const hashedPassword = await hashPassword(data.password);
    
      // ユーザー作成
      const user = await db.users.create({
        ...data,
        password: hashedPassword
      });
    
      return user;
    }
    

Phase 6.4: 自動修正ループ

テスト実行 → 失敗 → 自動修正 → テスト再実行
(最大5回までループ)

Phase 6.5: カバレッジ検証

サブエージェント活用(Bashエージェント並行実行):

エージェントタイプコマンド目的
テスト実行Bashnpm test -- --coverageカバレッジ95%以上確認
Mutation TestingBashnpx stryker runテスト品質検証(オプション)
npm test -- --coverage

カバレッジ目標:

  • Statements: 95%以上
  • Branches: 90%以上
  • Functions: 95%以上
  • Lines: 95%以上

メリット:

  • カバレッジ測定とMutation Testingを並行実行
  • 最終検証の時間を短縮

Phase 6.6: Mutation Testing(オプション)

npx stryker run

Mutation Score目標: 80%以上

Phase 6.7: 事後品質レビュー

  1. Code Review:

    • コード品質チェック
    • セキュリティ脆弱性スキャン
    • ベストプラクティス確認
  2. Design Review:

    • 設計書との整合性確認
    • アーキテクチャ原則遵守確認

Phase 6.8: コミット・PR作成

  1. コミット:

    git add .
    git commit -m "feat: implement user registration API"
    
  2. PR作成:

    gh pr create --title "feat: user registration" --body "..."
    
  3. CI/CD確認:

    • GitHub Actions実行確認
    • テスト合格確認

次のステップ

実装完了後、次のステップに進みます:

オプション1: 次のタスクを実装

dev スキルを再度実行して次のタスクを実装します。

/michi dev {pj-name}

オプション2: 実装検証

review-dev スキルを使用して実装を検証します。

/michi review-dev {pj-name}

オプション3: アーカイブ

すべてのタスクが完了したら、プロジェクトをアーカイブします。

/michi archive-pj {pj-name}

コードサイズ監視

code-size-monitor ルールにより、500行を超える変更は警告されます。 大規模な変更の場合は、タスクを分割することを推奨します。

参照

  • コードサイズルール: ../../rules/code-size-rules.md
  • TDDガイドライン: ../references/workflow-guide.md#tdd
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

次のスキル:

  • review-dev - 実装検証
  • archive-pj - プロジェクトアーカイブ(完了時)

launch-pj: プロジェクト初期化

プロジェクト初期化スキルは、新しいプロジェクトを開始するための基盤を作成します。

概要

このスキルは以下を実行します:

  1. 機能名生成: プロジェクト説明から一意の機能名(YYYYMMDD-{pj-name}形式)を生成
  2. ディレクトリ構造作成:
    • .michi/pj/YYYYMMDD-{pj-name}/ にメタデータディレクトリを作成
    • docs/michi/YYYYMMDD-{pj-name}/ に仕様書ディレクトリを作成
  3. メタデータ初期化: project.json を作成し、フェーズを initialized に設定
  4. 次フェーズ準備: 要件定義フェーズに進む準備を完了

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「新しいプロジェクトを開始したい」
  • 「仕様を初期化」
  • 「プロジェクトを作成」

明示的発動

/michi launch-pj "プロジェクト説明"

例:

/michi launch-pj "ユーザー認証機能"

実行内容

1. 機能名生成

プロジェクト説明から以下の形式で機能名を生成します:

YYYYMMDD-{pj-name}

例:

  • "ユーザー認証機能" → 20260117-user-auth
  • "商品検索API" → 20260117-product-search-api

2. ディレクトリ構造作成

以下のディレクトリを作成します:

.michi/pj/YYYYMMDD-{pj-name}/        # メタデータ(.gitignore対象)
docs/michi/YYYYMMDD-{pj-name}/       # 仕様書(Git管理される)
├── spec/
├── tasks/
├── research/
├── test-plan/
└── todos/

3. メタデータ初期化

.michi/pj/YYYYMMDD-{pj-name}/project.json を作成:

{
  "name": "{pj-name}",
  "fullName": "YYYYMMDD-{pj-name}",
  "description": "プロジェクト説明",
  "phase": "initialized",
  "createdAt": "2026-01-17T00:00:00Z",
  "updatedAt": "2026-01-17T00:00:00Z"
}

次のステップ

プロジェクト初期化が完了したら、次のステップに進みます:

推奨: 要件定義

create-requirements スキルを使用して要件定義書を作成します。

/michi create-requirements {pj-name}

または自動発動:

要件定義したい

参照

  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

次のスキル: create-requirements - 要件定義書作成

manage-todos: TODO管理

TODO管理スキルは、プロジェクトの不明点、仮定、リスク、技術的負債を一元管理するために使用します。

概要

このスキルは以下を実行します:

  1. TODO抽出: 既存ドキュメント(requirements.md、architecture.md、design.md、research.md)からTODOを抽出
  2. TODO追加: 新規TODOを対話的に追加
  3. TODO表示: カテゴリ別、優先度別にTODOを表示
  4. TODO解決: TODOを解決済みにマーク

TODOカテゴリ

カテゴリ略称説明例
QuestionQ確認が必要な不明点認証トークンの有効期限は?
AssumptionA暫定的に仮定している事項DBはPostgreSQLを使用すると仮定
RiskR識別されたリスク外部API障害時の動作が未定義
Tech DebtT技術的負債一時的なハードコーディングあり

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「TODOを確認したい」
  • 「不明点を整理」
  • 「仮定を確認」
  • 「リスクを管理」

明示的発動(サブコマンド)

1. scan - TODO抽出

既存ドキュメントからTODOを抽出します。

/michi manage-todos scan {pj-name}

抽出対象:

  • docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md
    • 「前提条件」セクションの仮定
    • 「制約事項」セクションの不明点
  • docs/michi/YYYYMMDD-{pj-name}/spec/architecture.md
    • 設計上のリスク
    • 技術選定の仮定
  • docs/michi/YYYYMMDD-{pj-name}/spec/design.md
    • 詳細設計の不明点
  • docs/michi/YYYYMMDD-{pj-name}/research/research.md
    • リスクセクション
  • src/**/*.ts, src/**/*.js
    • コード内のTODOコメント(// TODO:, /* TODO:)

認識パターン:

<!-- TODO: [Q] 認証トークンの有効期限は何分にすべきか? -->
- [ ] TODO: [A] DBはPostgreSQLを使用すると仮定

サブエージェント活用(並列TODO抽出):

scanサブコマンドで複数ドキュメントを並列検索します:

Phase 1: 並列TODO抽出
エージェント対象パターン出力
要件定義TODOspec/requirements.mdTODO: [Q], TODO: [A]要件TODOリスト
設計TODOspec/architecture.md, design.mdTODO: [R], TODO: [A], TODO: [T]設計TODOリスト
調査ログTODOresearch/research.mdすべてのカテゴリ調査TODOリスト
コードTODOsrc//*.ts, src//*.js// TODO:, /* TODO:コードTODOリスト
Phase 2: TODO統合(メインエージェント)
  • Phase 1の結果をマージ
  • 重複排除、優先度設定
  • todos.md生成

メリット:

  • ドキュメント横断検索の高速化
  • 各ドキュメントを独立して探索
  • TODO抽出精度の向上
2. show - TODO一覧表示

TODO一覧を表示します。

/michi manage-todos show {pj-name}

表示形式:

TODO一覧: user-auth

[Q] Question (2件)
  TODO-Q-001 ⚠️ High   | 認証トークンの有効期限は何分にすべきか?
  TODO-Q-002 📌 Medium | パスワードの最小文字数は?

[A] Assumption (1件)
  TODO-A-001 📌 Medium | DBはPostgreSQLを使用すると仮定

[R] Risk (1件)
  TODO-R-001 ⚠️ High   | 外部API障害時の動作が未定義

統計:
  全TODO: 4件
  未解決: 4件
  高優先度: 2件
3. add - TODO追加

新規TODOを対話的に追加します。

/michi manage-todos add {pj-name}

対話フロー (AskUserQuestion ツール使用):

  1. カテゴリ選択(Q / A / R / T)
    • AskUserQuestion でカテゴリを選択
  2. 優先度選択(High / Medium / Low)
    • AskUserQuestion で優先度を選択
  3. TODO内容入力
    • ユーザーに入力を促す
  4. todos/todos.md に追加
    • TODOをファイルに書き込み
4. resolve - TODO解決

TODOを解決済みにマークします。

/michi manage-todos resolve {pj-name} TODO-Q-001

実行内容:

  1. TODO内容を確認
    • 指定されたTODO IDの内容を表示
    • AskUserQuestion で解決を確認
  2. 解決内容を入力
    • ユーザーに解決方法・決定事項を入力させる
  3. TODOを解決済みにマーク
    • 解決日時を記録
    • 解決内容を追記
    • project.json を更新

対話的な確認フロー:

TODO-Q-001の内容:
  認証トークンの有効期限は何分にすべきか?

このTODOを解決済みにしますか?
> はい

解決内容を入力してください:
> 15分に決定。セキュリティ要件と合わせて確認済み。

✓ TODO-Q-001 を解決済みにマークしました

実行内容

1. TODOファイル構造

TODOは以下の構造で管理されます:

docs/michi/YYYYMMDD-{pj-name}/
└── todos/
    └── todos.md              # TODO一覧

2. todos.mdフォーマット

# TODO一覧: {pj-name}

## [Q] Question - 不明点

- [ ] TODO-Q-001 ⚠️ High | 認証トークンの有効期限は何分にすべきか?
  - 発見元: requirements.md
  - 登録日: 2026-01-17
- [x] TODO-Q-002 📌 Medium | パスワードの最小文字数は?
  - 発見元: requirements.md
  - 登録日: 2026-01-17
  - 解決日: 2026-01-18
  - 解決内容: 8文字以上に決定

## [A] Assumption - 仮定

- [ ] TODO-A-001 📌 Medium | DBはPostgreSQLを使用すると仮定
  - 発見元: architecture.md
  - 登録日: 2026-01-17

## [R] Risk - リスク

- [ ] TODO-R-001 ⚠️ High | 外部API障害時の動作が未定義
  - 発見元: research.md
  - 登録日: 2026-01-17

## [T] Tech Debt - 技術的負債

(なし)

---

統計:
- 全TODO: 3件
- 未解決: 3件
- 高優先度: 2件

既存スキルとの連携

create-requirements との連携

要件定義書生成後、以下を自動提案します:

要件定義書を生成しました。

TODOを抽出しますか?
  - manage-todos scan {pj-name}

create-design との連携

設計書生成後、リスク・不明点をTODOとして抽出提案します。

show-status との連携

ステータス表示時にTODO状況サマリーを含めます:

プロジェクト: user-auth
フェーズ: design-generated

タスク進捗: 3 / 10 完了 (30%)
TODO状況: 未解決 4件(高優先度 2件)

次のアクション:
  - 高優先度TODOを解決(manage-todos show)
  - テスト計画を立てる(plan-tests)

dev との連携

実装開始前に高優先度TODOの警告を表示します:

⚠️ 警告: 未解決の高優先度TODOがあります

TODO-Q-001: 認証トークンの有効期限は何分にすべきか?

実装を続行しますか?

次のステップ

TODO管理後、フェーズに応じて次のステップを実行します:

現在のフェーズ次のステップ
requirements-generatedcreate-design - 設計
design-generatedplan-tests または create-tasks
tasks-generateddev - TDD実装

参照

  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • create-requirements - 要件定義書作成
  • create-design - 設計書作成
  • show-status - ステータス表示
  • dev - TDD実装

multi-repo-create-design: マルチリポジトリ設計

C4モデルによるアーキテクチャ設計を行い、クロスリポジトリ整合性を考慮します。

概要

  1. C4モデル設計: 全リポジトリ統合のアーキテクチャを設計
  2. コンテナ間連携: リポジトリ間の通信を設計
  3. データフロー設計: データの流れを明示

使用方法

/michi-multi-repo create-design {pj-name}

実行内容

統合設計書を作成します:

# 統合設計: EC Platform

## C4モデル

### Level 1: Context
- システム境界
- 外部システムとの関係

### Level 2: Container
- frontend-web: React SPA
- backend-api: Node.js API Server
- mobile-app: React Native App

### コンテナ間連携
- frontend-web → backend-api: REST API (HTTPS)
- mobile-app → backend-api: REST API (HTTPS)

## データフロー

```mermaid
graph LR
    Frontend[frontend-web] -->|HTTPS| API[backend-api]
    Mobile[mobile-app] -->|HTTPS| API
    API --> DB[(PostgreSQL)]

## 次のステップ

```bash
/michi-multi-repo review-cross {pj-name}

次のスキル: multi-repo-review-cross

multi-repo-create-requirements: マルチリポジトリ要件定義

EARS形式の統合要件定義を生成し、リポジトリ間の依存関係を明記します。

概要

  1. EARS形式要件定義: 全リポジトリ統合の要件を定義
  2. リポジトリ間依存関係: 各リポジトリの役割と依存を明記
  3. インターフェース定義: リポジトリ間のインターフェースを定義

使用方法

/michi-multi-repo create-requirements {pj-name}

実行内容

統合要件定義書を作成します:

# 統合要件定義: EC Platform

## リポジトリ構成

### frontend-web
- 役割: Webフロントエンド
- 依存: backend-api

### backend-api
- 役割: APIサーバー
- 依存: なし

### mobile-app
- 役割: モバイルアプリ
- 依存: backend-api

## インターフェース定義

### backend-api → frontend-web
- API仕様: OpenAPI 3.0
- 認証: OAuth2

## 要件

### FR-001: ユーザー登録
- **リポジトリ**: backend-api, frontend-web, mobile-app
- **要件**: ユーザーは新規登録できる

次のステップ

/michi-multi-repo create-design {pj-name}

次のスキル: multi-repo-create-design

multi-repo-dev-all: 全リポジトリ並行実装

複数リポジトリで並行してTDD実装を行い、依存関係を考慮した実行順序で実装します。

概要

  1. 依存関係分析: リポジトリ間の依存を分析
  2. 実行順序決定: トポロジカルソートで順序を決定
  3. 並行実装: 依存のないリポジトリは並行実行

使用方法

/michi-multi-repo dev-all {pj-name}

サブエージェント活用(Plan + general-purpose)

複数リポジトリの並行実装をgeneral-purposeエージェントで実行します:

Phase 1: 依存関係分析(Plan)

Planエージェントで各リポジトリの依存関係を分析:

  • トポロジカルソートで実行順序を決定
  • 並行実行可能なリポジトリを特定

例:

backend-api: 依存なし → Phase 1で実装
frontend-web: backend-api に依存 → Phase 2で実装
mobile-app: backend-api に依存 → Phase 2で実装

Phase 2: 並行TDD実装(general-purpose x N)

依存関係のないリポジトリは並行してgeneral-purposeエージェントを起動:

  • 各エージェントがdevスキル相当の処理を実行
  • TDD実装(Red-Green-Refactor)
  • カバレッジ確認
  • PR作成

並行実行例:

Phase 1: backend-api を実装(general-purpose x 1)
Phase 2: frontend-web と mobile-app を並行実装(general-purpose x 2)

Phase 3: 統合確認(メインエージェント)

  • すべてのリポジトリのPRを確認
  • クロスリポジトリテストを実行

general-purposeエージェント活用のメリット:

  • 各リポジトリで独立したTDD実装が可能
  • 並行実行で全体の開発時間を短縮
  • 各エージェントが完全な開発権限を持つ

Planエージェント活用のメリット:

  • 依存関係の正確な分析
  • 実行順序の最適化
  • 並行実行タイミングの最適化

実行内容

依存関係分析

backend-api: 依存なし
frontend-web: backend-api に依存
mobile-app: backend-api に依存

実行順序

Phase 1: backend-api を実装
Phase 2: frontend-web と mobile-app を並行実装

並行実装

各リポジトリで以下を実行:

  1. ブランチ作成
  2. TDD実装(Red-Green-Refactor)
  3. テスト実行
  4. カバレッジ確認(95%以上)
  5. コミット・PR作成

完了条件

  • すべてのリポジトリで実装完了
  • すべてのテストが合格
  • カバレッジ95%以上
  • クロスリポジトリ整合性確認

次のステップ

全リポジトリの実装が完了したら、統合テストを実行します。

# 統合テスト実行
npm run test:integration

# アーカイブ
/michi archive-pj {pj-name}

参照

  • マルチリポガイド: ../references/multi-repo-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル: archive-pj - プロジェクトアーカイブ(完了時)

multi-repo-launch-pj: マルチリポジトリプロジェクト初期化

マルチリポジトリプロジェクト初期化スキルは、複数のリポジトリにまたがるプロジェクトを初期化します。

概要

このスキルは以下を実行します:

  1. プロジェクト初期化: 統合仕様を管理するプロジェクトを作成
  2. リポジトリリスト作成: 対象リポジトリのリストを作成
  3. メタデータ作成: templates/multi-repo/project.json から初期化

使用方法

明示的発動

/michi-multi-repo launch-pj "プロジェクト説明"

例:

/michi-multi-repo launch-pj "EC Platform"

実行内容

1. プロジェクト初期化

templates/multi-repo/project.json から初期化します:

{
  "name": "ec-platform",
  "fullName": "20260117-ec-platform",
  "description": "EC Platform",
  "type": "multi-repo",
  "repositories": [
    "frontend-web",
    "backend-api",
    "mobile-app"
  ],
  "phase": "initialized"
}

2. ディレクトリ構造作成

.michi/pj/YYYYMMDD-{pj-name}/
docs/michi/YYYYMMDD-{pj-name}/
├── spec/
│   ├── requirements.md
│   ├── architecture.md
│   └── sequence.md
└── test-plan/

次のステップ

初期化が完了したら、統合要件定義を作成します。

/michi-multi-repo create-requirements {pj-name}

参照

  • マルチリポガイド: ../references/multi-repo-guide.md
  • コマンドリファレンス: ../references/command-reference.md

次のスキル: multi-repo-create-requirements - 統合要件定義

multi-repo-propagate: 各リポジトリへ仕様展開

統合仕様を各リポジトリに展開し、並行実行で効率化します。

概要

  1. 統合仕様読み込み: 統合要件定義・設計を読み込み
  2. リポジトリごとに仕様抽出: 各リポジトリに関連する部分を抽出
  3. 並行展開: 各リポジトリに仕様を展開(並行実行)

使用方法

/michi-multi-repo propagate {pj-name}

実行内容

各リポジトリに仕様を展開します:

並行実行:
  - frontend-web: requirements.md, design.md を作成
  - backend-api: requirements.md, design.md を作成
  - mobile-app: requirements.md, design.md を作成

完了後、各リポジトリに仕様ファイルが配置されます。

展開先:

frontend-web/docs/specs/YYYYMMDD-{pj-name}/
backend-api/docs/specs/YYYYMMDD-{pj-name}/
mobile-app/docs/specs/YYYYMMDD-{pj-name}/

次のステップ

/michi-multi-repo dev-all {pj-name}

次のスキル: multi-repo-dev-all

multi-repo-review-cross: クロスリポジトリ整合性検証

各リポジトリの仕様間の整合性を検証し、インターフェース不整合を検出します。

概要

  1. インターフェース整合性: API仕様の一致を確認
  2. データモデル整合性: データ構造の一致を確認
  3. 依存関係検証: リポジトリ間の依存が正しいか確認

使用方法

/michi-multi-repo review-cross {pj-name}

サブエージェント活用(リポジトリ並列探索)

各リポジトリを個別のExploreエージェントで並列探索します:

Phase 1: リポジトリ並列探索(最大10個)

各リポジトリに対して1つのExploreエージェントを割り当て:

  • API呼び出し / APIエンドポイント一覧
  • 型定義
  • 依存関係 → 各リポジトリの仕様サマリーを出力

Phase 2: クロスリポジトリ整合性検証(メインエージェント)

  • Phase 1の結果を突合
  • インターフェース不整合検出
  • 依存関係グラフ生成
  • 整合性レポート生成

メリット:

  • 複数リポジトリの並列探索
  • 探索時間を大幅短縮
  • 各リポジトリの独立した分析

実行内容

クロスリポジトリ検証を実行します:

# クロスリポジトリ整合性検証結果

## インターフェース整合性

### API仕様
- ✅ backend-api の OpenAPI仕様とfrontend-web の型定義が一致
- ⚠️ mobile-app の型定義が古い(backend-api v1.2.0 vs mobile-app v1.1.0)

## データモデル整合性

- ✅ User型の定義が全リポジトリで一致

## 依存関係

- ✅ 循環依存なし
- ✅ 依存方向が正しい(frontend/mobile → backend)

次のステップ

/michi-multi-repo propagate {pj-name}

次のスキル: multi-repo-propagate

plan-tests: テスト計画作成

テスト計画作成スキルは、テスト戦略(Phase 0.3)とテスト仕様(Phase 0.4)を作成します。

概要

このスキルは以下を実行します:

  1. 設計書参照: design.md, architecture.md を読み込んで設計を把握
  2. テスト戦略作成(Phase 0.3): テスト方針、テストレベル、テスト環境を定義
  3. テスト仕様作成(Phase 0.4): 単体・統合・E2E・パフォーマンステストの詳細仕様を作成
  4. テスト計画書生成:
    • docs/michi/YYYYMMDD-{pj-name}/test-plan/strategy.md
    • docs/michi/YYYYMMDD-{pj-name}/test-plan/unit/
    • docs/michi/YYYYMMDD-{pj-name}/test-plan/integration/
    • docs/michi/YYYYMMDD-{pj-name}/test-plan/e2e/
    • docs/michi/YYYYMMDD-{pj-name}/test-plan/performance/
  5. フェーズ更新: project.json のフェーズを test-plan-generated に更新

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「テスト計画を立てたい」
  • 「テスト戦略を作成」
  • project.json の phase: "design-generated" の場合に自動提案

明示的発動

/michi plan-tests {pj-name}

例:

/michi plan-tests user-auth

実行内容

1. 設計書参照

以下のファイルを読み込んで設計を把握します:

  • docs/michi/YYYYMMDD-{pj-name}/spec/design.md
  • docs/michi/YYYYMMDD-{pj-name}/spec/architecture.md
  • docs/michi/YYYYMMDD-{pj-name}/spec/requirements.md

2. テスト戦略作成(Phase 0.3)

docs/michi/YYYYMMDD-{pj-name}/test-plan/strategy.md を作成します:

# テスト戦略: {pj-name}

## テスト方針
- TDD(テスト駆動開発)を基本とする
- カバレッジ95%以上を目標
- Mutation Testing を実施(オプション)

## テストレベル

### 単体テスト(Unit Test)
- 対象: 個別の関数・クラス
- ツール: Jest / Vitest
- カバレッジ目標: 95%以上

### 統合テスト(Integration Test)
- 対象: コンポーネント間の連携
- ツール: Supertest / TestContainers
- カバレッジ目標: 80%以上

### E2Eテスト(End-to-End Test)
- 対象: ユーザーシナリオ
- ツール: Playwright / Cypress
- カバレッジ目標: 主要シナリオ100%

### パフォーマンステスト(Performance Test)
- 対象: レスポンスタイム、スループット
- ツール: k6 / Artillery
- 目標: レスポンスタイム < 200ms

## テスト環境
- ローカル: Docker Compose
- CI/CD: GitHub Actions
- ステージング: AWS ECS

## テストデータ
- テストDBは毎回リセット
- Fixture を使用してデータを準備

## 継続的インテグレーション
- すべてのテストはPR作成時に自動実行
- テスト失敗時はマージブロック

3. テスト仕様作成(Phase 0.4)

各テストレベルの詳細仕様を作成します:

単体テスト仕様

docs/michi/YYYYMMDD-{pj-name}/test-plan/unit/{feature}.md:

# 単体テスト仕様: {feature}

## テストケース一覧

### TC-U-001: 正常系 - ユーザー登録
- 入力: email, password
- 期待結果: ユーザーが作成され、IDが返される

### TC-U-002: 異常系 - 重複メールアドレス
- 入力: 既存のメールアドレス
- 期待結果: エラーが返される(409 Conflict)

### TC-U-003: 異常系 - 無効なメールアドレス
- 入力: 無効な形式のメールアドレス
- 期待結果: バリデーションエラーが返される
統合テスト仕様

docs/michi/YYYYMMDD-{pj-name}/test-plan/integration/{feature}.md:

# 統合テスト仕様: {feature}

## テストケース一覧

### TC-I-001: API → DB連携
- 前提: DBが起動している
- 実行: POST /api/users
- 検証: DBにユーザーが保存されている

### TC-I-002: 認証フロー
- 前提: ユーザーが登録済み
- 実行: POST /api/login
- 検証: トークンが返され、セッションが保存されている
E2Eテスト仕様

docs/michi/YYYYMMDD-{pj-name}/test-plan/e2e/{scenario}.md:

# E2Eテスト仕様: ユーザー登録〜ログイン

## シナリオ

1. ユーザー登録ページにアクセス
2. メールアドレスとパスワードを入力
3. 登録ボタンをクリック
4. 確認メールを受信
5. メール内のリンクをクリック
6. ログインページにアクセス
7. 登録したメールアドレスとパスワードでログイン
8. ダッシュボードにリダイレクト

## 期待結果

- ダッシュボードに「ようこそ、{username}さん」と表示される
パフォーマンステスト仕様

docs/michi/YYYYMMDD-{pj-name}/test-plan/performance/{api}.md:

# パフォーマンステスト仕様: ログインAPI

## 負荷シナリオ

- Virtual Users: 100
- Duration: 5 minutes
- Ramp-up: 30 seconds

## 目標

- レスポンスタイム(P95): < 200ms
- エラー率: < 0.1%
- スループット: > 500 req/sec

4. フェーズ更新

project.json のフェーズを更新します:

{
  "phase": "test-plan-generated",
  "updatedAt": "2026-01-17T00:00:00Z"
}

次のステップ

テスト計画が完了したら、次のステップに進みます:

推奨: タスク分割

create-tasks スキルを使用してタスクに分割します。

/michi create-tasks {pj-name}

または自動発動:

タスクに分割したい

参照

  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

次のスキル: create-tasks - タスク分割

review-design: 設計レビュー

設計レビュースキルは、設計書の技術的妥当性、セキュリティ、テスト計画準備状況を確認します。

概要

このスキルは以下を実行します:

  1. 設計書読み込み: architecture.md, design.md, sequence.md を読み込み
  2. 技術的妥当性確認:
    • アーキテクチャの整合性
    • データモデルの正規化
    • API設計のRESTful準拠
  3. セキュリティチェック:
    • OWASP Top 10 準拠確認
    • 認証・認可の実装確認
    • データ暗号化の確認
  4. テスト計画準備状況確認:
    • テストしやすい設計か
    • モックしやすいインターフェースか
  5. レビュー結果レポート: 問題点と改善提案を記載

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「設計をレビューしたい」
  • 「設計レビュー」
  • project.json の phase: "design-generated" の場合に自動提案

明示的発動

/michi review-design {pj-name}

例:

/michi review-design user-auth

サブエージェント活用(並列チェック)

設計書のレビューを3つのExploreエージェントで並列実行します:

Phase 1: 並列チェック

エージェント対象チェック項目出力
技術的妥当性チェックarchitecture.md, design.mdレイヤー分離、依存関係、正規化、RESTful技術的問題リスト
セキュリティチェックdesign.md, sequence.mdOWASP Top 10、認証・認可、暗号化セキュリティ問題リスト
テスタビリティチェックarchitecture.md, design.mdDI使用、インターフェース分離、モック容易性テスタビリティ問題リスト

Phase 2: レポート統合(メインエージェント)

  • Phase 1の結果を統合
  • 重大度分類(Critical/Major/Minor)
  • レビュー結果レポート生成

メリット:

  • レビュー品質の向上
  • 複数の観点から独立して検証
  • 検証タスクの並列化による時間短縮

実行内容

1. 設計書読み込み

以下のファイルを読み込みます:

  • docs/michi/YYYYMMDD-{pj-name}/spec/architecture.md
  • docs/michi/YYYYMMDD-{pj-name}/spec/design.md
  • docs/michi/YYYYMMDD-{pj-name}/spec/sequence.md

2. 技術的妥当性確認

アーキテクチャの整合性:

  • レイヤー分離が適切か
  • 依存関係が一方向か
  • 責任分担が明確か

データモデルの正規化:

  • 第3正規形まで正規化されているか
  • 適切なインデックスが設計されているか

API設計のRESTful準拠:

  • HTTPメソッドが適切に使用されているか
  • ステータスコードが適切か
  • リソース設計が適切か

3. セキュリティチェック

OWASP Top 10 準拠確認:

  • SQL Injection対策
  • XSS対策
  • CSRF対策
  • 認証・認可の実装

データ暗号化:

  • パスワードのハッシュ化
  • 通信の暗号化(HTTPS)
  • 機密データの暗号化

4. テスト計画準備状況確認

テストしやすい設計:

  • 依存性注入(DI)が使用されているか
  • インターフェース分離がされているか

モックしやすいインターフェース:

  • 外部依存がインターフェース化されているか
  • テストダブルが使いやすいか

5. レビュー結果レポート

レビュー結果を以下の形式でレポートします:

# 設計レビュー結果: {pj-name}

## サマリー
- **合格/不合格**: 合格
- **重大な問題**: 0件
- **軽微な問題**: 2件
- **改善提案**: 3件

## 重大な問題
(なし)

## 軽微な問題

### LI-001: データベースインデックス不足
- **説明**: email カラムにインデックスがない
- **影響**: ログイン時のクエリ性能低下
- **推奨対応**: email カラムに UNIQUE INDEX を追加

### LI-002: エラーハンドリング不足
- **説明**: 外部API呼び出しのエラーハンドリングが不足
- **影響**: 外部API障害時にシステムが停止する可能性
- **推奨対応**: リトライロジックを追加

## 改善提案

### REC-001: キャッシュ層の追加
- **説明**: 頻繁にアクセスされるデータをキャッシュする
- **効果**: レスポンスタイム短縮

### REC-002: 非同期処理の導入
- **説明**: メール送信を非同期化する
- **効果**: ユーザーレスポンス改善

### REC-003: モニタリング設計
- **説明**: メトリクス・ログ・トレースを設計に含める
- **効果**: 運用時の問題検知が容易になる

次のステップ

設計レビューが完了したら、次のステップに進みます:

問題がある場合: 設計を修正

設計書を修正して、再度レビューを実行します。

/michi create-design {pj-name}
/michi review-design {pj-name}

問題がない場合: テスト計画またはタスク分割

/michi plan-tests {pj-name}

または

/michi create-tasks {pj-name}

参照

  • セキュリティガイドライン: ~/.claude/security/CLAUDE-security-policy.md
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • create-design - 設計書作成(修正時)
  • plan-tests - テスト計画作成(合格後)
  • create-tasks - タスク分割(合格後)

review-dev: 実装検証

実装検証スキルは、実装されたコードの品質、テストカバレッジ、セキュリティ脆弱性を確認します。

概要

このスキルは以下を実行します:

  1. コード品質チェック:
    • ESLint / Prettier / Checkstyle などの静的解析
    • コードの複雑度測定
    • コードスメル検出
  2. テストカバレッジ確認:
    • カバレッジ95%以上を確認
    • 未カバー箇所を特定
  3. セキュリティ脆弱性スキャン:
    • Snyk / Trivy などのセキュリティスキャン
    • OWASP Top 10 準拠確認
  4. 設計書との整合性確認:
    • 実装が設計書に準拠しているか
  5. 検証結果レポート: 問題点と改善提案を記載

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「実装を検証したい」
  • 「実装レビュー」
  • dev スキルの Phase 6.7 で自動実行

明示的発動

/michi review-dev {pj-name}

例:

/michi review-dev user-auth

サブエージェント活用(並列検証)

実装検証をExploreエージェントとBashエージェントで並列実行します:

Phase 1: 並列検証

エージェントタイプ実行内容出力
コード品質チェックBashnpm run lint静的解析レポート
カバレッジ確認Bashnpm test -- --coverageカバレッジレポート
セキュリティスキャンBashnpm audit && snyk test脆弱性リスト
整合性確認Explore実装コード vs 設計書不整合リスト
コードスメル検出Explore複雑度、重複、長い関数コードスメルリスト

Phase 2: レポート統合(メインエージェント)

  • Phase 1の結果を統合
  • 合格/不合格判定
  • 検証結果レポート生成

Bashエージェント活用のメリット:

  • npm/yarnコマンドを並行実行
  • セキュリティスキャンの待ち時間を短縮
  • 各コマンドの出力を独立して収集

Exploreエージェント活用のメリット:

  • コードベースの高速探索
  • 設計書との整合性確認
  • コードスメルの検出

実行内容

1. コード品質チェック

静的解析:

npm run lint
npm run format:check

コード複雑度測定:

  • Cyclomatic Complexity: 10以下を推奨
  • Cognitive Complexity: 15以下を推奨

コードスメル検出:

  • 重複コード
  • 長すぎる関数(50行以上)
  • 長すぎるパラメータリスト(5個以上)
  • 深いネスト(4階層以上)

2. テストカバレッジ確認

npm test -- --coverage

カバレッジ目標:

  • Statements: 95%以上
  • Branches: 90%以上
  • Functions: 95%以上
  • Lines: 95%以上

未カバー箇所の特定:

  • カバレッジレポートを分析
  • 未テスト箇所を特定
  • 追加テストを提案

3. セキュリティ脆弱性スキャン

依存パッケージスキャン:

npm audit
snyk test

コンテナイメージスキャン:

trivy image {image-name}

OWASP Top 10 準拠確認:

  • SQL Injection対策の実装確認
  • XSS対策の実装確認
  • CSRF対策の実装確認
  • 認証・認可の実装確認

4. 設計書との整合性確認

以下を確認します:

  • API仕様が設計書と一致しているか
  • データモデルが設計書と一致しているか
  • シーケンス図の処理フローと一致しているか

5. 検証結果レポート

検証結果を以下の形式でレポートします:

# 実装検証結果: {pj-name}

## サマリー
- **合格/不合格**: 合格
- **コード品質**: ✅ 問題なし
- **テストカバレッジ**: ✅ 96.5% (目標95%以上)
- **セキュリティ**: ⚠️ 軽微な問題1件
- **設計整合性**: ✅ 問題なし

## コード品質

### 静的解析
- ESLint: 0 errors, 0 warnings
- Prettier: フォーマット済み

### コード複雑度
- 最大 Cyclomatic Complexity: 8 (目標10以下)
- 最大 Cognitive Complexity: 12 (目標15以下)

### コードスメル
- 重複コード: 1箇所(utils.ts:45-60)

## テストカバレッジ

- Statements: 96.5%
- Branches: 91.2%
- Functions: 97.1%
- Lines: 96.3%

### 未カバー箇所
- src/auth.ts:line 105-110 (エラーハンドリング)
  - 推奨: 例外発生時のテストを追加

## セキュリティ

### 依存パッケージ
- npm audit: 0 vulnerabilities

### OWASP Top 10
- SQL Injection: ✅ Parameterized Query使用
- XSS: ✅ エスケープ処理実装
- CSRF: ⚠️ CSRF tokenが未実装
  - 推奨: CSRF tokenを追加

## 設計整合性

- API仕様: ✅ 設計書と一致
- データモデル: ✅ 設計書と一致
- シーケンス図: ✅ 処理フローと一致

次のステップ

実装検証が完了したら、次のステップに進みます:

問題がある場合: 修正

問題を修正して、再度検証を実行します。

# 修正後
/michi review-dev {pj-name}

問題がない場合: PR作成またはアーカイブ

# PR作成
gh pr create --title "feat: user authentication" --body "..."

# または全タスク完了時はアーカイブ
/michi archive-pj {pj-name}

参照

  • コード品質ガイドライン: ~/.claude/team/CLAUDE-team-standards.md
  • セキュリティガイドライン: ~/.claude/security/CLAUDE-security-policy.md
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • dev - TDD実装(修正時)
  • archive-pj - プロジェクトアーカイブ(完了時)

show-status: ステータス表示

ステータス表示スキルは、プロジェクトの現在の進捗状況を確認するために使用します。

概要

このスキルは以下の情報を表示します:

  1. プロジェクト基本情報: プロジェクト名、説明、作成日時
  2. 現在のフェーズ: initialized, requirements-generated, design-generated, tasks-generated, implementation-complete など
  3. タスク進捗: 完了タスク数 / 全タスク数
  4. 次のアクション: 次に実行すべきステップの提案

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「進捗を確認したい」
  • 「ステータスを表示」
  • 「現在の状況は?」

明示的発動

/michi show-status {pj-name}

例:

/michi show-status user-auth

実行内容

1. プロジェクト情報読み込み

.michi/pj/YYYYMMDD-{pj-name}/project.json からメタデータを読み込みます。

2. 進捗状況分析

以下を分析します:

  • 現在のフェーズ
  • タスクの完了状況(docs/michi/YYYYMMDD-{pj-name}/tasks/tasks.md を参照)
  • 承認状況(project.json の approvals フィールド)
  • TODO状況(docs/michi/YYYYMMDD-{pj-name}/todos/todos.md を参照)
    • 全TODO数
    • 未解決TODO数
    • 高優先度TODO数

3. ステータス表示

以下の形式で表示します:

プロジェクト: user-auth
説明: ユーザー認証機能
フェーズ: design-generated
作成日: 2026-01-15
更新日: 2026-01-17

タスク進捗: 3 / 10 完了 (30%)
TODO状況: 未解決 4件(高優先度 2件)

次のアクション:
  - 高優先度TODOを解決(manage-todos show)
  - テスト計画を立てる(plan-tests)
  - タスクに分割する(create-tasks)

次のステップ

ステータス確認後、フェーズに応じて次のステップを実行します:

現在のフェーズ次のステップ
initializedcreate-requirements - 要件定義
requirements-generatedcreate-design - 設計
design-generatedplan-tests または create-tasks
tasks-generateddev - TDD実装
implementation-completearchive-pj - アーカイブ

参照

  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • launch-pj - プロジェクト初期化
  • archive-pj - プロジェクトアーカイブ
  • switch-pj - プロジェクト切り替え

switch-pj: プロジェクト切り替え

プロジェクト切り替えスキルは、複数のプロジェクトを並行して管理する際に、現在作業中のプロジェクトを切り替えます。

概要

このスキルは以下を実行します:

  1. プロジェクト一覧表示: .michi/pj/ 内の全プロジェクトを表示
  2. プロジェクト選択: ユーザーが切り替え先のプロジェクトを選択
  3. コンテキスト変更: 現在のコンテキストを切り替え先のプロジェクトに変更
  4. ステータス表示: 切り替え先のプロジェクトのステータスを表示

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「プロジェクトを切り替えたい」
  • 「別のプロジェクトに切り替え」
  • 「プロジェクトを変更」

明示的発動

/michi switch-pj

または、プロジェクト名を指定:

/michi switch-pj {pj-name}

例:

/michi switch-pj user-auth

実行内容

1. プロジェクト一覧表示

.michi/pj/ 内の全プロジェクトを表示します:

利用可能なプロジェクト:

1. 20260115-user-auth (要件定義完了)
2. 20260116-product-search (設計完了)
3. 20260117-payment-integration (初期化済み)

切り替え先のプロジェクトを選択してください。

2. プロジェクト選択

ユーザーがプロジェクトを選択します(番号またはプロジェクト名)。

3. コンテキスト変更

以下を更新します:

  • 現在のプロジェクトコンテキスト
  • project.json のメタデータ
  • Claude のセッション変数

4. ステータス表示

切り替え後、選択されたプロジェクトのステータスを表示します:

プロジェクトを切り替えました: user-auth

プロジェクト: user-auth
フェーズ: design-generated
次のアクション: テスト計画(plan-tests)またはタスク分割(create-tasks)

使用例

並行開発のシナリオ

複数のプロジェクトを並行して進める場合:

  1. プロジェクトAで要件定義
  2. プロジェクトBに切り替えて設計
  3. プロジェクトAに戻って設計
  4. プロジェクトCを新規作成
  5. プロジェクトBに切り替えて実装
/michi launch-pj "プロジェクトA"
/michi create-requirements project-a

/michi switch-pj project-b
/michi create-design project-b

/michi switch-pj project-a
/michi create-design project-a

/michi launch-pj "プロジェクトC"

/michi switch-pj project-b
/michi dev project-b

次のステップ

プロジェクト切り替え後、show-status で現在のステータスを確認し、次のステップに進みます。

/michi show-status {pj-name}

参照

  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • show-status - ステータス表示(切り替え後に確認)
  • launch-pj - 新規プロジェクト初期化
  • archive-pj - プロジェクトアーカイブ(完了後)

update-master-docs: マスタードキュメント更新

マスタードキュメント更新スキルは、プロジェクト横断の共通知識を更新します。

概要

このスキルは以下を実行します:

  1. マスタードキュメント読み込み: 既存のマスタードキュメントを確認
  2. 変更内容分析: プロジェクト固有の知見から共通化できる要素を抽出
  3. マスタードキュメント更新:
    • docs/master-docs/structure.md - システム構造
    • docs/master-docs/tech.md - 技術スタック
    • docs/master-docs/product.md - プロダクト要件
  4. バージョン管理: 変更履歴を記録

使用方法

自動発動

以下のキーワードで自動発動します:

  • 「マスタードキュメントを更新したい」
  • 「共通知識を更新」
  • プロジェクト完了時に自動提案

明示的発動

/michi update-master-docs

または、特定のドキュメントのみ更新:

/michi update-master-docs --doc structure
/michi update-master-docs --doc tech
/michi update-master-docs --doc product

実行内容

1. マスタードキュメント読み込み

以下のファイルを読み込みます:

docs/master-docs/
├── structure.md   # システム構造
├── tech.md        # 技術スタック
└── product.md     # プロダクト要件

2. 変更内容分析

プロジェクト固有の知見から共通化できる要素を抽出します:

  • 新しいアーキテクチャパターン
  • 新しい技術スタック
  • プロダクト要件の変更
  • ベストプラクティス

3. マスタードキュメント更新

structure.md - システム構造

システム全体の構造を定義します:

# システム構造

## アーキテクチャ概要

### レイヤー構造
- Presentation Layer: API Gateway, UI
- Application Layer: Business Logic
- Domain Layer: Domain Models
- Infrastructure Layer: Database, External Services

## コンポーネント一覧

### API Gateway
- 役割: リクエストルーティング、認証・認可
- 技術: Kong / AWS API Gateway

### Authentication Service
- 役割: ユーザー認証
- 技術: OAuth2, JWT
tech.md - 技術スタック

プロジェクトで使用する技術スタックを定義します:

# 技術スタック

## 言語・フレームワーク
- **Backend**: Node.js 20.x, TypeScript 5.x
- **Frontend**: React 18.x, Next.js 14.x
- **Mobile**: React Native 0.73.x

## データベース
- **RDB**: PostgreSQL 16.x
- **NoSQL**: MongoDB 7.x
- **Cache**: Redis 7.x

## インフラ
- **Cloud**: AWS
- **Container**: Docker, Kubernetes
- **CI/CD**: GitHub Actions
product.md - プロダクト要件

プロダクト全体の要件を定義します:

# プロダクト要件

## ビジョン
...

## ターゲットユーザー
...

## 主要機能
1. ユーザー認証
2. 商品検索
3. 決済処理
...

## 非機能要件
- パフォーマンス: レスポンスタイム < 200ms
- 可用性: 99.9% SLA
- セキュリティ: OWASP Top 10 準拠

4. バージョン管理

変更履歴を各ドキュメントの末尾に記録します:

## 変更履歴

- 2026-01-17: ユーザー認証機能の追加 (user-auth プロジェクト)
- 2026-01-15: 商品検索APIの追加 (product-search プロジェクト)

次のステップ

マスタードキュメント更新後、次のプロジェクトで参照できるようになります。

新しいプロジェクトでは、更新されたマスタードキュメントを参照して要件定義・設計を行います。

/michi launch-pj "新しいプロジェクト"
/michi create-requirements new-project

注意事項

  • 共通化のバランス: すべてをマスタードキュメントに書くのではなく、本当に共通化すべき要素のみを抽出
  • プロジェクト固有の詳細: 各プロジェクトの詳細は、そのプロジェクトの仕様書に記載
  • 定期的な見直し: 技術スタックやアーキテクチャの変更に応じて定期的に見直す

参照

  • マスタードキュメント原則: ~/.michi/settings/rules/master-docs-principles.md
  • ワークフロー全体: ../references/workflow-guide.md
  • コマンドリファレンス: ../references/command-reference.md

関連スキル:

  • create-requirements - 要件定義(マスタードキュメントを参照)
  • create-design - 設計(マスタードキュメントを参照)

Sponsors

Details

Marketplace
sk8metalme/michi
Source
plugins/michi
Category
Community