npm - @sk8metal/michi-cli - Versions diffs - 0.10.1 → 0.11.0 - Mend

@sk8metal/michi-cli 0.10.1 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (104) hide show

package/README.md +77 -847
package/dist/scripts/phase-runner.js +1 -1
package/dist/scripts/phase-runner.js.map +1 -1
package/dist/scripts/utils/multi-repo-validator.d.ts +18 -0
package/dist/scripts/utils/multi-repo-validator.d.ts.map +1 -1
package/dist/scripts/utils/multi-repo-validator.js +42 -0
package/dist/scripts/utils/multi-repo-validator.js.map +1 -1
package/dist/scripts/utils/tasks-format-validator.js +3 -3
package/dist/scripts/utils/tasks-format-validator.js.map +1 -1
package/docs/README.md +20 -83
package/docs/getting-started/configuration.md +379 -0
package/docs/getting-started/installation.md +59 -0
package/docs/getting-started/quick-start.md +76 -0
package/docs/guides/ai-tools.md +311 -0
package/docs/guides/atlassian-integration.md +116 -0
package/docs/guides/claude-code.md +155 -0
package/docs/guides/multi-repo.md +117 -0
package/docs/guides/workflow.md +382 -0
package/docs/reference/ai-commands.md +92 -0
package/docs/reference/cli.md +756 -0
package/docs/reference/environment-variables.md +192 -0
package/docs/troubleshooting.md +543 -0
package/package.json +1 -1
package/scripts/phase-runner.ts +1 -1
package/scripts/utils/__tests__/multi-repo-validator.test.ts +159 -1
package/scripts/utils/multi-repo-validator.ts +50 -0
package/scripts/utils/tasks-format-validator.ts +3 -3
package/templates/claude/agents/e2e-first-planner/AGENT.md +1 -1
package/templates/claude/agents/pr-resolver/AGENT.md +15 -3
package/templates/claude/commands/michi/e2e-plan.md +1 -1
package/templates/claude/commands/michi/spec-design.md +2 -2
package/templates/claude/commands/michi/spec-tasks.md +156 -0
package/templates/claude/commands/michi/test-planning.md +1 -1
package/templates/claude/commands/michi/validate-design.md +3 -3
package/templates/claude/commands/michi-multi-repo/impl-all.md +30 -1
package/templates/claude/commands/michi-multi-repo/propagate-specs.md +14 -1
package/templates/claude/commands/michi-multi-repo/spec-review.md +16 -2
package/templates/claude-agent/agents/repo-spec-executor.md +1 -1
package/templates/claude-agent/commands/michi/spec-tasks.md +117 -0
package/templates/claude-agent/rules/code-size-monitor.md +26 -0
package/templates/claude-agent/rules/code-size-rules.md +32 -0
package/templates/codex/AGENTS.override.md +1 -1
package/templates/codex/rules/README.md +2 -2
package/templates/cursor/commands/michi/spec-tasks.md +117 -0
package/templates/michi/cc-sdd-overrides/settings/rules/design-review-michi.md +1 -1
package/docs/context.md +0 -59
package/docs/michi-development/contributing/development.md +0 -341
package/docs/michi-development/contributing/release.md +0 -365
package/docs/michi-development/design/config-unification.md +0 -733
package/docs/michi-development/design/design-config-current-state.md +0 -330
package/docs/michi-development/design/design-config-implementation.md +0 -628
package/docs/michi-development/design/design-config-migration.md +0 -952
package/docs/michi-development/design/design-config-security.md +0 -771
package/docs/michi-development/design/design-config-solution.md +0 -583
package/docs/michi-development/design/design-config-testing.md +0 -892
package/docs/michi-development/testing/manual-verification-flow.md +0 -871
package/docs/michi-development/testing/manual-verification-other-tools.md +0 -1279
package/docs/michi-development/testing/manual-verification-troubleshooting.md +0 -122
package/docs/michi-development/testing/pre-publish-checklist.md +0 -560
package/docs/michi-development/testing-strategy.md +0 -87
package/docs/plan.md +0 -275
package/docs/user-guide/getting-started/github-token-setup.md +0 -510
package/docs/user-guide/getting-started/new-repository-setup.md +0 -704
package/docs/user-guide/getting-started/quick-start.md +0 -212
package/docs/user-guide/getting-started/setup.md +0 -819
package/docs/user-guide/guides/agent-skills-integration.md +0 -222
package/docs/user-guide/guides/customization.md +0 -537
package/docs/user-guide/guides/internationalization.md +0 -540
package/docs/user-guide/guides/migration-guide.md +0 -138
package/docs/user-guide/guides/multi-project.md +0 -368
package/docs/user-guide/guides/multi-repo-guide.md +0 -1590
package/docs/user-guide/guides/phase-automation.md +0 -419
package/docs/user-guide/guides/workflow.md +0 -574
package/docs/user-guide/hands-on/README.md +0 -142
package/docs/user-guide/hands-on/claude-agent-setup.md +0 -597
package/docs/user-guide/hands-on/claude-setup.md +0 -452
package/docs/user-guide/hands-on/cursor-setup.md +0 -353
package/docs/user-guide/hands-on/troubleshooting.md +0 -964
package/docs/user-guide/hands-on/verification-checklist.md +0 -439
package/docs/user-guide/hands-on/workflow-walkthrough.md +0 -1078
package/docs/user-guide/reference/config.md +0 -589
package/docs/user-guide/reference/multi-repo-api.md +0 -771
package/docs/user-guide/reference/quick-reference.md +0 -297
package/docs/user-guide/reference/security-test-payloads.md +0 -50
package/docs/user-guide/reference/tasks-template.md +0 -550
package/docs/user-guide/release/ci-setup-java.md +0 -114
package/docs/user-guide/release/ci-setup-nodejs.md +0 -94
package/docs/user-guide/release/ci-setup-php.md +0 -102
package/docs/user-guide/release/ci-setup-troubleshooting.md +0 -94
package/docs/user-guide/release/ci-setup.md +0 -188
package/docs/user-guide/release/release-flow.md +0 -476
package/docs/user-guide/templates/test-specs/README.md +0 -173
package/docs/user-guide/templates/test-specs/e2e-test-spec-template.md +0 -553
package/docs/user-guide/templates/test-specs/integration-test-spec-template.md +0 -435
package/docs/user-guide/templates/test-specs/performance-test-spec-template.md +0 -454
package/docs/user-guide/templates/test-specs/security-test-spec-template.md +0 -625
package/docs/user-guide/templates/test-specs/unit-test-spec-template.md +0 -328
package/docs/user-guide/testing/integration-tests.md +0 -312
package/docs/user-guide/testing/tdd-cycle.md +0 -349
package/docs/user-guide/testing/test-execution-flow.md +0 -396
package/docs/user-guide/testing/test-failure-handling.md +0 -521
package/docs/user-guide/testing/test-planning-flow.md +0 -185
package/docs/user-guide/testing-strategy.md +0 -185
package/docs/verification-guide.md +0 -518

package/docs/michi-development/contributing/development.md DELETED Viewed

@@ -1,341 +0,0 @@
-# Michi 開発環境セットアップガイド
-このガイドは、Michiプロジェクト自体の開発に貢献したい開発者向けのセットアップ手順です。
-Michiを使ってプロジェクト開発を始めたい場合は、[利用者向けセットアップガイド](../getting-started/setup.md)を参照してください。
-## 前提条件
-- Node.js 20.x以上
-- npm 10.x以上
-- Git または Jujutsu (jj)
-- Cursor IDE または VS Code
-- GitHub CLI (gh) - PR作成時に使用
-## 1. リポジトリのフォーク・クローン
-### Gitを使う場合
-```bash
-# リポジトリをフォーク（GitHubのWebインターフェースで実行）
-# フォークしたリポジトリをクローン
-git clone https://github.com/YOUR_USERNAME/michi
-cd michi
-# 上流リポジトリをremoteに追加
-git remote add upstream https://github.com/sk8metalme/michi
-```
-### Jujutsu (jj) を使う場合
-```bash
-# リポジトリをクローン
-jj git clone https://github.com/YOUR_USERNAME/michi
-cd michi
-# 上流リポジトリを設定
-jj git remote add upstream https://github.com/sk8metalme/michi
-```
-## 2. 依存関係のインストール
-```bash
-npm install
-```
-## 3. cc-sddのインストール（開発用）
-```bash
-# Cursor IDE を使用する場合
-npx cc-sdd@latest --lang ja --cursor
-# Claude Code を使用する場合
-npx cc-sdd@latest --lang ja --claude
-```
-## 4. 環境変数の設定
-開発環境でも、Confluence/JIRA連携のテストのために環境変数が必要です。
-```bash
-# テンプレートファイルをコピー
-cp env.example .env
-```
-詳細な設定方法は、[利用者向けセットアップガイド](../getting-started/setup.md#3-環境変数の設定)を参照してください。
-## 5. 開発ワークフロー
-### ブランチ戦略
-- `main`: 本番環境相当（常にデプロイ可能な状態）
-- `feature/XXX`: 機能開発用
-- `bugfix/XXX`: バグ修正用
-- `docs/XXX`: ドキュメント更新用
-### 開発サイクル
-1. **issueを作成** または 既存のissueを確認
-2. **ブランチを作成**
-   ```bash
-   git checkout -b feature/your-feature-name
-   # または jj new -m "feature/your-feature-name"
-   ```
-3. **コードを実装**
-4. **テストを追加・実行**
-5. **コミット**
-6. **PRを作成**
-## 6. コーディング規約
-### TypeScript
-- **Strict Mode**: `tsconfig.json`で厳格な型チェックを有効化
-- **ESLint**: すべてのコードはESLintルールに準拠
-- **Prettier**: コードフォーマットは自動化
-### コミットメッセージ
-[Conventional Commits](https://www.conventionalcommits.org/)形式を使用：
-```
-<type>(<scope>): <subject>
-<body>
-<footer>
-```
-**Type:**
-- `feat`: 新機能
-- `fix`: バグ修正
-- `docs`: ドキュメント変更
-- `style`: コードフォーマット（ロジック変更なし）
-- `refactor`: リファクタリング
-- `test`: テスト追加・修正
-- `chore`: ビルドプロセスやツールの変更
-**例:**
-```
-feat(confluence): Confluence階層構造のカスタマイズ機能を追加
-- config.jsonでhierarchy.modeを設定可能に
-- simple/detailedの2モードをサポート
-Closes #123
-```
-## 7. テストの実行
-### 全テストを実行
-```bash
-npm run test:run
-```
-### watchモードでテスト
-```bash
-npm test
-```
-### カバレッジ確認
-```bash
-npm run test:coverage
-```
-**カバレッジ目標**: 95%以上
-### 型チェック
-```bash
-npm run type-check
-```
-## 8. リントとフォーマット
-### リント実行
-```bash
-npm run lint
-```
-### リント自動修正
-```bash
-npm run lint:fix
-```
-### フォーマット
-```bash
-npm run format
-```
-## 8-1. Pre-commitフック（自動リント・テスト）
-このプロジェクトでは、**husky**と**lint-staged**を使用して、コミット前に自動的にリントとテストを実行します。
-### 動作
-コミットを実行すると、以下の処理が自動的に実行されます：
-1. **lint-staged**: ステージングされたファイルに対して自動リント・フォーマット
-   - TypeScript/JavaScriptファイル: ESLint自動修正 + Prettierフォーマット
-   - JSON/Markdown/YAMLファイル: Prettierフォーマット
-2. **テスト実行**: すべてのテストを実行（`npm run test:run`）
-### フックをスキップする場合（非推奨）
-緊急時のみ、以下の方法でフックをスキップできます：
-```bash
-# Gitの場合
-git commit --no-verify -m "緊急修正"
-# Jujutsuの場合
-jj commit --no-verify -m "緊急修正"
-```
-**注意**: フックをスキップしたコミットは、CI/CDで失敗する可能性があります。
-### フックの設定確認
-```bash
-# pre-commitフックの内容を確認
-cat .husky/pre-commit
-# lint-stagedの設定を確認
-cat package.json | grep -A 10 "lint-staged"
-```
-## 9. ビルドとパッケージング
-### TypeScriptビルド
-```bash
-npm run build
-```
-### ローカルでのパッケージテスト
-```bash
-# パッケージをリンク
-npm link
-# 他のプロジェクトでテスト
-cd /path/to/test-project
-npm link @sk8metal/michi-cli
-# テスト後、リンクを解除
-npm unlink @sk8metal/michi-cli
-```
-## 10. PRの作成
-### PR作成前のチェックリスト
-- [ ] すべてのテストがパス
-- [ ] カバレッジが95%以上
-- [ ] ESLintエラーが0件
-- [ ] TypeScript型エラーが0件
-- [ ] コミットメッセージがConventional Commits形式
-- [ ] ドキュメントを更新（必要に応じて）
-### PRの作成
-```bash
-# GitHubにプッシュ
-git push origin feature/your-feature-name
-# PRを作成
-gh pr create --title "feat: 機能の説明" --body "詳細な説明"
-```
-### Jujutsuの場合
-```bash
-# 変更をコミット
-jj commit -m "feat: 機能の説明"
-# GitHubにプッシュ
-jj git push
-# PRを作成
-gh pr create --title "feat: 機能の説明" --body "詳細な説明"
-```
-### PRテンプレート
-```markdown
-## 概要
-何を実装したか簡潔に説明
-## 変更内容
-- 変更点1
-- 変更点2
-## テスト
-- [ ] 単体テスト追加
-- [ ] E2Eテスト追加（必要に応じて）
-- [ ] 手動テスト実施
-## チェックリスト
-- [ ] テストがパス
-- [ ] カバレッジ95%以上
-- [ ] ESLintエラー0件
-- [ ] ドキュメント更新
-## 関連Issue
-Closes #123
-```
-## 11. CI/CDパイプライン
-プッシュすると、以下のCI/CDパイプラインが自動実行されます：
-- **リント**: ESLint実行
-- **型チェック**: TypeScriptコンパイル
-- **テスト**: Vitest実行
-- **カバレッジ**: Codecovにアップロード
-- **セキュリティスキャン**: npm auditとSnyk
-詳細は [CI/CDガイド](./ci-cd.md) を参照してください。
-## 12. トラブルシューティング
-### npm install でエラーが出る
-キャッシュをクリア：
-```bash
-npm cache clean --force
-rm -rf node_modules package-lock.json
-npm install
-```
-### テストが失敗する
-```bash
-# キャッシュをクリア
-npm run test:run -- --clearCache
-# 特定のテストのみ実行
-npm run test:run -- path/to/test-file.test.ts
-```
-### GitHub認証エラー
-```bash
-gh auth status
-gh auth login
-gh auth setup-git
-```
-## 参考リンク
-- [コントリビューションガイド](../../CONTRIBUTING.md)
-- [リリース手順](./release.md)
-- [CI/CD設定](./ci-cd.md)
-- [Jujutsu公式ドキュメント](https://martinvonz.github.io/jj/)

package/docs/michi-development/contributing/release.md DELETED Viewed

@@ -1,365 +0,0 @@
-# リリース手順
-このドキュメントでは、Michiプロジェクトのリリース手順を説明します。
-## 概要
-Michiプロジェクトでは、GitHub Actionsを使用して自動リリースを行います。`v*`形式のGitタグを作成すると、自動的に以下が実行されます：
-1. テスト実行（`npm run test:run`）
-2. リント実行（`npm run lint`）
-3. 型チェック（`npm run type-check`）
-4. ビルド（`npm run build`）
-5. NPMパッケージ公開（`npm publish`）
-6. GitHub Release作成
-詳細は [`.github/workflows/release.yml`](../.github/workflows/release.yml) を参照してください。
-## リリース前のチェックリスト
-リリースを実行する前に、以下を確認してください：
-- [ ] すべてのテストが通過している（`npm run test:run`）
-- [ ] リントエラーがない（`npm run lint`）
-- [ ] 型チェックが成功している（`npm run type-check`）
-- [ ] ビルドが成功する（`npm run build`）
-- [ ] `package.json`のバージョン番号が正しい
-- [ ] `CHANGELOG.md`が最新の状態である
-- [ ] 未コミットの変更がない（`jj status`または`git status`で確認）
-- [ ] NPM_TOKENがGitHub Secretsに設定されている（初回リリース時のみ確認）
-### NPM_TOKENの設定
-初回リリース時、またはNPM_TOKENが未設定の場合は、以下の手順で設定してください：
-1. NPMアカウントでAutomation Tokenを生成
-   - https://www.npmjs.com/settings/[your-username]/tokens にアクセス
-   - "Generate New Token" > "Automation" を選択
-   - トークンをコピー（一度しか表示されません）
-2. GitHub Secretsに追加
-   - リポジトリの Settings > Secrets and variables > Actions
-   - "New repository secret" をクリック
-   - Name: `NPM_TOKEN`
-   - Secret: コピーしたトークンを貼り付け
-   - "Add secret" をクリック
-詳細は [NPM_TOKEN設定ガイド](./tmp/npm-token-setup.md) を参照してください。
-## リリースワークフロー
-リリースは**プルリク経由**で行います。
-**メリット**:
-- 変更内容をレビューできる
-- CI/CDで自動チェックが実行される
-- チーム内で変更を共有できる
-- リリースとバージョン更新が独立している
-**ワークフロー**:
-1. バージョン更新（package.json、CHANGELOG.md）
-2. プルリク作成
-3. レビュー・マージ
-4. タグ作成（GitHub UIまたはコマンドライン）
-5. 自動リリース実行
-## バージョン更新手順
-### Step 1: package.jsonのバージョン更新
-`package.json`の`version`フィールドを更新します：
-```json
-{
-  "name": "@sk8metal/michi-cli",
-  "version": "0.0.4",  // 例: 0.0.3 → 0.0.4
-  ...
-}
-```
-**セマンティックバージョニング**に従ってバージョンを決定してください：
-- **MAJOR** (x.0.0): 破壊的変更
-- **MINOR** (0.x.0): 新機能追加（後方互換性あり）
-- **PATCH** (0.0.x): バグ修正、ドキュメント更新
-### Step 2: CHANGELOG.mdの更新
-`CHANGELOG.md`に新しいバージョンのエントリを追加します。
-**形式**: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) に準拠
-**例**:
-```markdown
-## [0.0.4] - 2025-11-13
-### Added
-- 新機能の説明
-### Changed
-- 変更内容の説明
-### Fixed
-- バグ修正の説明
-### Dependencies
-- Updated `package-name` from `^old-version` to `^new-version`
-```
-**日付形式**: `YYYY-MM-DD`（ISO 8601形式）
-### Step 3: プルリクの作成
-変更をコミットしてプルリクを作成します：
-```bash
-# 作業ディレクトリに移動
-cd /Users/arigatatsuya/Work/git/michi
-# 未コミット変更を確認
-jj status
-# または
-git status
-# 新しいブランチで作業開始（Jujutsuの場合）
-jj new main
-# または（Gitの場合）
-git checkout -b release/v0.0.4
-# 変更をコミット
-jj commit -m "chore: bump version to 0.0.4"
-# または
-git add package.json CHANGELOG.md
-git commit -m "chore: bump version to 0.0.4"
-# ブックマーク作成（Jujutsuの場合）
-jj bookmark create release/v0.0.4 -r '@-'
-# プッシュ
-jj git push --bookmark release/v0.0.4 --allow-new
-# または
-git push origin release/v0.0.4
-# プルリク作成（GitHub CLIを使用）
-gh pr create --head release/v0.0.4 --base main \
-  --title "chore: bump version to 0.0.4" \
-  --body "バージョンを0.0.3から0.0.4に更新します。
-## 変更内容
-- package.jsonのバージョン更新
-- CHANGELOG.mdに0.0.4のエントリを追加
-## リリース手順
-このPRがマージされた後、GitHub UIまたはコマンドラインからタグを作成してリリースを実行してください。"
-```
-### Step 4: プルリクのレビュー・マージ
-1. CI/CDが成功することを確認
-2. 必要に応じてレビューを依頼
-3. マージを実行
-**重要**: プルリクがマージされた後、mainブランチに変更が反映されてからタグを作成してください。
-## Gitタグの作成とプッシュ
-プルリクがマージされた後、タグを作成してリリースを実行します。
-### 方法A: GitHub UIからタグを作成（推奨）
-**手順**:
-1. **GitHubリポジトリのReleasesページにアクセス**
-   - リポジトリページで "Releases" をクリック
-   - または直接: `https://github.com/sk8metalme/michi/releases`
-2. **"Draft a new release" をクリック**
-   - または "Create a new release" をクリック
-3. **タグとリリース情報を入力**
-   - **Tag version**: `v0.0.4`（例）
-   - **Target**: `main`（デフォルト）
-   - **Release title**: `Release v0.0.4`（自動生成される）
-   - **Description**: CHANGELOG.mdの内容をコピー&ペースト
-4. **"Publish release" をクリック**
-   - これにより、タグが作成され、GitHub Actionsが自動的にリリース処理を開始します
-**メリット**:
-- リリースノートを同時に作成できる
-- タグとリリースが1つの操作で完了
-- 視覚的に確認しやすい
-### 方法B: コマンドラインからタグを作成
-#### Jujutsu (jj) を使用する場合
-```bash
-# 作業ディレクトリに移動
-cd /Users/arigatatsuya/Work/git/michi
-# リモートの最新状態を取得
-jj git fetch
-# mainブランチを最新に更新
-jj bookmark set main -r 'main@origin'
-# 最新のmainから作業開始
-jj new main
-# Gitタグを作成（jj経由でGitコマンドを実行）
-git tag v0.0.4
-# タグをプッシュ
-git push origin v0.0.4
-```
-**注意**: JujutsuはChange IDベースで管理するため、タグはGitコマンドで直接作成します。
-#### Gitを使用する場合
-```bash
-# 作業ディレクトリに移動
-cd /Users/arigatatsuya/Work/git/michi
-# mainブランチに切り替え
-git checkout main
-# 最新の状態を取得
-git pull origin main
-# タグを作成
-git tag v0.0.4
-# タグをプッシュ
-git push origin v0.0.4
-```
-**タグ名の形式**: `v` + バージョン番号（例: `v0.0.4`）
-GitHub Actionsのリリースワークフローは`v*`形式のタグでトリガーされます。
-## 自動リリースの確認
-タグをプッシュすると、GitHub Actionsが自動的にリリース処理を開始します。
-### 1. GitHub Actionsの実行状況を確認
-1. GitHubリポジトリのページにアクセス
-2. "Actions" タブをクリック
-3. "Release" ワークフローを確認
-4. 実行状況を監視
-**URL例**: `https://github.com/sk8metalme/michi/actions/workflows/release.yml`
-### 2. 各ステップの確認
-リリースワークフローは以下の順序で実行されます：
-1. ✅ **Checkout code** - コードのチェックアウト
-2. ✅ **Setup Node.js** - Node.js環境のセットアップ
-3. ✅ **Install dependencies** - 依存関係のインストール
-4. ✅ **Run tests** - テスト実行
-5. ✅ **Run lint** - リント実行
-6. ✅ **Run type check** - 型チェック
-7. ✅ **Build** - ビルド実行
-8. ✅ **Publish to NPM** - NPMパッケージ公開
-9. ✅ **Create GitHub Release** - GitHub Release作成
-すべてのステップが成功することを確認してください。
-### 3. NPM公開の確認
-NPMパッケージが正常に公開されたか確認します：
-```bash
-# NPMパッケージの情報を確認
-npm view @sk8metal/michi-cli version
-# 最新バージョンが表示されることを確認
-# 例: 0.0.4
-```
-**NPMパッケージページ**: https://www.npmjs.com/package/@sk8metal/michi-cli
-### 4. GitHub Releaseの確認
-GitHub Releaseが正常に作成されたか確認します：
-1. GitHubリポジトリの "Releases" ページにアクセス
-2. 最新のリリースが表示されることを確認
-3. リリースノートが正しく表示されることを確認
-**URL例**: `https://github.com/sk8metalme/michi/releases`
-## トラブルシューティング
-### エラー1: NPM公開が失敗する
-**症状**: "Publish to NPM" ステップでエラーが発生
-**原因**:
-- NPM_TOKENが未設定または無効
-- パッケージ名が既に使用されている（通常は発生しない）
-- バージョン番号が既に存在する
-**対処法**:
-1. GitHub SecretsでNPM_TOKENが正しく設定されているか確認
-2. NPM_TOKENが有効期限内か確認（Automation Tokenは無期限）
-3. バージョン番号が既に存在しないか確認（`npm view @sk8metal/michi-cli versions`）
-### エラー2: テストが失敗する
-**症状**: "Run tests" ステップでエラーが発生
-**対処法**:
-1. ローカルでテストを実行して確認（`npm run test:run`）
-2. テストコードを修正
-3. 再度コミット・プッシュしてタグを作成
-### エラー3: ビルドが失敗する
-**症状**: "Build" ステップでエラーが発生
-**対処法**:
-1. ローカルでビルドを実行して確認（`npm run build`）
-2. TypeScriptのコンパイルエラーを修正
-3. 再度コミット・プッシュしてタグを作成
-### エラー4: タグが既に存在する
-**症状**: `git tag v0.0.4` で "tag already exists" エラー
-**対処法**:
-1. 既存のタグを削除（ローカル）: `git tag -d v0.0.4`
-2. 既存のタグを削除（リモート）: `git push origin --delete v0.0.4`
-3. 新しいタグを作成: `git tag v0.0.4`
-4. タグをプッシュ: `git push origin v0.0.4`
-**注意**: 既にリリース済みのタグを削除する場合は、慎重に判断してください。
-### エラー5: GitHub Actionsが実行されない
-**症状**: タグをプッシュしたが、GitHub Actionsが実行されない
-**対処法**:
-1. タグ名が`v*`形式か確認（例: `v0.0.4`）
-2. GitHub Actionsが有効になっているか確認（Settings > Actions > General）
-3. ワークフローファイル（`.github/workflows/release.yml`）が正しいか確認
-## リリース後の確認事項
-リリースが正常に完了したら、以下を確認してください：
-- [ ] NPMパッケージが最新バージョンで公開されている
-- [ ] GitHub Releaseが作成されている
-- [ ] リリースノートが正しく表示されている
-- [ ] パッケージが正常にインストールできる（`npm install -g @sk8metal/michi-cli`）
-## 参考リンク
-- [GitHub Actions公式ドキュメント](https://docs.github.com/ja/actions)
-- [NPM公開ガイド](https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry)
-- [セマンティックバージョニング](https://semver.org/)
-- [Keep a Changelog](https://keepachangelog.com/)
-- [CI/CD整備計画](./tmp/cicd-plan.md)