Michi (道)
Managed Intelligent Comprehensive Hub for Integration
AI駆動開発ワークフロー自動化プラットフォーム
概要
Michiは、開発フロー全体（要件定義→設計→タスク分割→実装→テスト→リリース）をAIで自動化するプラットフォームです。
Powered by cc-sdd
主な機能
- ✅ AI駆動開発: Claude Code統合
- ✅ テスト計画統合: Phase 0.3-0.4でテストタイプ選択とテスト仕様書作成
- ✅ 品質自動化: OSSライセンスチェック、バージョン監査、自動レビュー
- ✅ Confluence/JIRA連携: 自動同期、タスク管理、進捗追跡
- ✅ Multi-Repo管理: マイクロサービス・モノレポ対応
- ✅ 多言語サポート: Node.js、Java（Gradle）、PHP対応
コードアーキテクチャ
Michiは**オニオンアーキテクチャ（4層構造）**を採用しています：
┌─────────────────────────────────────────┐
│ Presentation Layer (CLI) │ ← ユーザーインターフェース
├─────────────────────────────────────────┤
│ Application Layer (Use Cases) │ ← ビジネスロジック調整
├─────────────────────────────────────────┤
│ Infrastructure Layer (External APIs) │ ← 外部サービス統合
├─────────────────────────────────────────┤
│ Domain Layer (Business Logic) │ ← コアビジネスルール
└─────────────────────────────────────────┘
ハイブリッドアプローチ:
src/- プロダクションコード（4層構造）scripts/- ビルド・開発ツール（層なし）
詳細は アーキテクチャガイド と 移行ガイド を参照してください。
ワークフローアーキテクチャ
GitHub (.michi/specs/) ← 情報源（Single Source of Truth）
↓ 自動同期
Confluence ← ドキュメント管理
JIRA ← タスク管理・進捗追跡
クイックスタート
Claude Codeプラグイン（推奨）
前提条件: cc-sdd（Spec-Driven Development Core）をセットアップ
npx cc-sdd@latest --claude --lang ja
Michiプラグインのインストール - Claude Code内で実行:
/plugin marketplace add sk8metalme/michi
/plugin install michi@sk8metalme
推奨プラグイン - 併せてインストール:
/plugin marketplace add sk8metalme/ai-agent-setup
/plugin install design-review@ai-agent-setup
/plugin install oss-compliance@ai-agent-setup
/plugin install version-audit@ai-agent-setup
/plugin install e2e-planning@ai-agent-setup
CLIツール（外部ツール連携用）
JIRA/Confluence連携やリリース自動化には、CLIツールを併用します。
npm install -g @sk8metal/michi-cli
注意: michi setup --claude コマンドは廃止予定です。上記のプラグインインストールを使用してください。
基本的な使い方
# 1. 仕様を初期化
/kiro:spec-init "calculator-app: 四則演算を行う電卓アプリ"
# 2. 要件定義
/kiro:spec-requirements calculator-app
# 3. 設計（テスト計画統合版）
/michi:spec-design calculator-app
# 4. タスク分割（JIRA同期確認付き）
/michi:spec-tasks calculator-app
# 5. TDD実装
/michi:spec-impl calculator-app
詳細は クイックスタートガイド を参照してください。
ドキュメント
完全なドキュメントは docs/ を参照してください。
はじめに
ガイド
- ワークフロー - 開発フロー全体の説明
- Atlassian連携 - JIRA/Confluence連携
- Multi-Repo管理 - マイクロサービス開発
- Claude Code - Claude Code統合
- 統括動作確認手順書 - 全機能網羅の動作確認手順（85項目）
リファレンス
- CLIコマンド - すべてのmichiコマンド
- AIコマンド - /kiro:*, /michi:*コマンド
- 環境変数 - 環境変数一覧
- アーキテクチャ - オニオンアーキテクチャ（4層構造）
- 移行ガイド - アーキテクチャ移行の詳細
トラブルシューティング
- トラブルシューティング - よくある問題と解決策
ワークフロー構造
Michiは以下のフェーズで構成されています:
cc-sdd標準フェーズ
- Phase 0.0-0.2: 仕様化（初期化、要件定義、設計）
- Phase 0.5: タスク分割
- Phase 2: TDD実装
Michi拡張フェーズ
- Phase 0.3-0.4: テスト計画（テストタイプ選択、テスト仕様書作成）
- Phase 0.6-0.7: 外部ツール連携（JIRA、Confluence）
- Phase 1: 環境構築・基盤整備
- Phase A: PR前自動テスト（単体テスト、Lint、ビルド）
- Phase 3: 追加品質保証（PRマージ後）
- Phase B: リリース準備テスト（統合、E2E、パフォーマンス、セキュリティ）
- Phase 4-5: リリース準備と実行
詳細は ワークフローガイド を参照してください。
技術スタック
対応言語・ツール
- Node.js/TypeScript: npm
- Java: Gradle（Mavenは非対応）
- PHP: Composer
対応AIツール
- Claude Code - AI駆動開発ツール（推奨）
- Claude Code Subagents - カスタムサブエージェント統合
外部連携
- Atlassian: Confluence（ドキュメント管理）、JIRA（タスク管理）
- GitHub: Issue、PR、Actions
ライセンス
MIT License - 詳細は LICENSE を参照してください。
コントリビューション
貢献を歓迎します！詳細は CONTRIBUTING.md を参照してください。
サポート
- GitHub Issues: https://github.com/sk8metalme/michi/issues
- ドキュメント: docs/