npm - yodogawa - Versions diffs - 1.0.0 - Mend

yodogawa 1.0.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 (61) hide show

package/.windsurf/templates/documentation-rules.md +143 -0
package/.windsurf/templates/project/01-requirements/01-system-overview.md +49 -0
package/.windsurf/templates/project/01-requirements/02-features-implemented.md +73 -0
package/.windsurf/templates/project/01-requirements/03-features-planned.md +75 -0
package/.windsurf/templates/project/01-requirements/04-non-functional-requirements.md +115 -0
package/.windsurf/templates/project/01-requirements/05-user-stories.md +124 -0
package/.windsurf/templates/project/02-behavior/01-scenarios.md +406 -0
package/.windsurf/templates/project/03-domain/01-domain-model.md +338 -0
package/.windsurf/templates/project/03-domain/02-ubiquitous-language.md +153 -0
package/.windsurf/templates/project/04-design/01-tech-stack.md +360 -0
package/.windsurf/templates/project/04-design/02-repository-structure.md +390 -0
package/.windsurf/templates/project/04-design/03-screen-design.md +586 -0
package/.windsurf/templates/project/04-design/04-data-model.md +211 -0
package/.windsurf/templates/project/04-design/05-api-spec.md +221 -0
package/.windsurf/templates/project/04-design/06-architecture.md +183 -0
package/.windsurf/templates/project/04-design/07-infrastructure.md +180 -0
package/.windsurf/templates/tasks/task-template/a-definition.md +143 -0
package/.windsurf/templates/tasks/task-template/b-research.md +185 -0
package/.windsurf/templates/tasks/task-template/c-implementation.md +197 -0
package/.windsurf/workflows/a-001-SetupDocStructure.md +165 -0
package/.windsurf/workflows/a-002-InitializeProject.md +229 -0
package/.windsurf/workflows/a-003-CreateScenarios.md +130 -0
package/.windsurf/workflows/a-004-DefineDomainModel.md +133 -0
package/.windsurf/workflows/a-005-CreateDomainDiagram.md +114 -0
package/.windsurf/workflows/a-006-ReviewRequirementsDomain.md +132 -0
package/.windsurf/workflows/a-007-DefineTechStack.md +121 -0
package/.windsurf/workflows/a-008-DefineRepositoryStructure.md +118 -0
package/.windsurf/workflows/a-009-DefineScreenDesign.md +121 -0
package/.windsurf/workflows/a-010-DefineDataModel.md +125 -0
package/.windsurf/workflows/a-011-DefineAPISpec.md +123 -0
package/.windsurf/workflows/a-012-DefineArchitecture.md +119 -0
package/.windsurf/workflows/a-013-DefineInfrastructure.md +120 -0
package/.windsurf/workflows/a-014-ReviewDesign.md +122 -0
package/.windsurf/workflows/b-001-CreateTaskDirectory.md +71 -0
package/.windsurf/workflows/b-002-CreateTaskDefinition.md +165 -0
package/.windsurf/workflows/b-003-CreateTaskResearch.md +412 -0
package/.windsurf/workflows/b-004-CreateTaskImplementation.md +97 -0
package/.windsurf/workflows/b-005-ReviewTask.md +312 -0
package/.windsurf/workflows/c-001-ImplementTask.md +493 -0
package/.windsurf/workflows/c-002-UpdateDocumentation.md +797 -0
package/.windsurf/workflows/x-Accessibility-Check.md +469 -0
package/.windsurf/workflows/x-Bundle-Optimize.md +386 -0
package/.windsurf/workflows/x-CI-FixFailure.md +636 -0
package/.windsurf/workflows/x-CI-Setup.md +641 -0
package/.windsurf/workflows/x-Code-Refactor.md +71 -0
package/.windsurf/workflows/x-Code-ResearchAndReview.md +78 -0
package/.windsurf/workflows/x-Component-Create.md +359 -0
package/.windsurf/workflows/x-Context-CatchUp.md +63 -0
package/.windsurf/workflows/x-Database-Seed.md +300 -0
package/.windsurf/workflows/x-Dependencies-Update.md +315 -0
package/.windsurf/workflows/x-DevEnvironment-Setup.md +437 -0
package/.windsurf/workflows/x-Logging-Add.md +682 -0
package/.windsurf/workflows/x-Migration-Create.md +354 -0
package/.windsurf/workflows/x-Problem-RootCauseAnalysis.md +65 -0
package/.windsurf/workflows/x-Repository-Push.md +375 -0
package/.windsurf/workflows/x-Repository-PushToGithub.md +72 -0
package/.windsurf/workflows/x-Requirements-Clarify.md +61 -0
package/.windsurf/workflows/z-CreateWorkflow.md +77 -0
package/README.md +280 -0
package/bin/cli.js +74 -0
package/package.json +28 -0

package/.windsurf/workflows/x-Repository-Push.md ADDED Viewed

@@ -0,0 +1,375 @@
+---
+description: ローカル変更を検証し、安全なコミットとリモートリポジトリへのプッシュを行うワークフロー（GitHub/GitLab対応）
+auto_execution_mode: 1
+---
+# Repository-Push (x-Repository-Push)
+## 目的
+- ローカル変更をレビュー・テストした上で、適切なブランチ運用とコミットメッセージでリモートリポジトリにプッシュする。
+- コンフリクトやCI失敗を未然に防ぎ、チームと共有できる状態で提出する。
+- GitHub、GitLab など複数のGitホスティングサービスに対応する。
+- 必要なドキュメンテーション更新や追跡情報を整備した上で変更を公開する。
+## 前提
+- ローカルリポジトリがリモート（origin）と接続されている。
+- コミット対象の変更内容を把握しており、未保存ファイルや不要な変更がない。
+- 動作確認に必要なテストやビルドコマンドが実行でき、依存ツールが揃っている。
+- 認証情報（PAT / SSH鍵など）が有効で、リモートリポジトリへの push 権限がある。
+- プッシュ前に README / ドキュメント / ワークフローを更新する必要がある場合は、その方針を決めている。
+## 手順
+### 1. リモートリポジトリの確認
+**リモートURLの確認**:
+```bash
+git remote -v
+```
+**プラットフォームの特定**:
+- github.com → GitHub
+- gitlab.com → GitLab
+- その他のセルフホストインスタンス
+**認証方法の確認**:
+- SSH: `git@github.com:user/repo.git`
+- HTTPS: `https://github.com/user/repo.git`
+### 2. 最新状態への同期
+**ブランチ戦略の確認**:
+- GitHub Flow: main ブランチから feature ブランチ
+- GitLab Flow: main → pre-production → production
+- Git Flow: develop → feature, develop → release
+- Trunk-based: main ブランチのみ
+**同期コマンド**:
+```bash
+# 現在の状態確認
+git status
+# リモートの最新状態を取得
+git fetch --prune
+# ベースブランチを最新化（例: main）
+git checkout main
+git pull origin main
+# 作業ブランチに戻る
+git checkout <feature-branch>
+# 最新の変更を取り込む（リベースまたはマージ）
+git rebase origin/main
+# または
+git merge origin/main
+```
+### 3. ローカル検証
+**テスト実行**:
+```bash
+# Lint チェック
+<lint-command>
+# ユニットテスト
+<test-command>
+# E2Eテスト（必要に応じて）
+<e2e-test-command>
+# ビルド確認
+<build-command>
+```
+**検証項目**:
+- [ ] すべてのテストが通過する
+- [ ] Lint エラーがない
+- [ ] ビルドが成功する
+- [ ] 新機能が正常に動作する
+- [ ] 既存機能に影響がない
+**エラーが出た場合**:
+- エラーを修正
+- 再度テストを実行
+- 成功を確認してから次のステップへ
+### 4. 変更内容の整理
+**変更の確認**:
+```bash
+# 変更されたファイルを確認
+git status
+# 変更内容の詳細を確認
+git diff
+# ステージングエリアの確認
+git diff --staged
+```
+**不要なファイルの除外**:
+- [ ] 一時ファイルが含まれていない
+- [ ] ビルド成果物が含まれていない（.gitignore で管理）
+- [ ] 機密情報が含まれていない
+- [ ] デバッグコードが削除されている
+**コミット単位の分割**（必要に応じて）:
+- 大きな変更は複数のコミットに分割
+- 各コミットは独立して意味のある単位に
+- 論理的に関連する変更をまとめる
+### 5. ドキュメントとメタ情報の更新
+**ドキュメント更新**:
+- [ ] README.md の更新（新機能、使い方）
+- [ ] CHANGELOG.md の更新（変更内容、バージョン）
+- [ ] API ドキュメントの更新
+- [ ] コメント・JSDoc の更新
+**Issue/タスク管理との連携**:
+- GitHub: `Fixes #123`, `Closes #456`
+- GitLab: `Closes #123`, `Related to #456`
+- Jira: `PROJ-123`, `PROJ-456`
+### 6. コミットの実行
+**コミットメッセージの作成**:
+チーム規約に従ったフォーマットを使用:
+**Conventional Commits 形式**:
+```
+<type>(<scope>): <subject>
+<body>
+<footer>
+```
+**Type の種類**:
+- `feat`: 新機能
+- `fix`: バグ修正
+- `docs`: ドキュメント
+- `style`: フォーマット
+- `refactor`: リファクタリング
+- `test`: テスト追加
+- `chore`: ビルド・設定変更
+**コミット実行**:
+```bash
+# ファイルをステージング
+git add <files>
+# コミット
+git commit -m "feat: add user authentication
+- Add login/logout functionality
+- Add JWT token management
+- Add protected routes
+Fixes #123
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+Co-Authored-By: Claude <noreply@anthropic.com>"
+```
+**コミット履歴の整理**（必要に応じて）:
+```bash
+# 直前のコミットを修正
+git commit --amend
+# 複数コミットを整理（インタラクティブリベース）
+git rebase -i HEAD~3
+```
+### 7. プッシュ前の最終確認
+**確認項目**:
+- [ ] `git status` が clean である
+- [ ] 不要な stash が残っていない
+- [ ] コミットメッセージが正しい
+- [ ] テストが通過している
+- [ ] ドキュメントが更新されている
+**リモートの最新状態確認**:
+```bash
+# リモートの変更を確認
+git fetch
+# リモートとの差分を確認
+git log origin/<branch>..HEAD
+# 必要なら再度リベース
+git rebase origin/<base-branch>
+```
+### 8. リモートリポジトリへのプッシュ
+**プッシュコマンド**:
+**初回プッシュ（ブランチが存在しない場合）**:
+```bash
+git push -u origin <branch-name>
+```
+**通常のプッシュ**:
+```bash
+git push origin <branch-name>
+```
+**強制プッシュ（慎重に）**:
+```bash
+# リベース後など、必要な場合のみ
+git push --force-with-lease origin <branch-name>
+# 注意: main/master への強制プッシュは避ける
+```
+**プッシュ結果の確認**:
+- プッシュが成功したか確認
+- エラーがあればログを確認
+- リモートブランチが作成されたか確認
+### 9. Pull Request / Merge Request の作成
+**プラットフォーム別のコマンド**:
+**GitHub CLI**:
+```bash
+# PR作成
+gh pr create --title "Add user authentication" --body "Implements login/logout functionality. Fixes #123"
+# PR の状態確認
+gh pr status
+# PR のURLを開く
+gh pr view --web
+```
+**GitLab CLI**:
+```bash
+# MR作成
+glab mr create --title "Add user authentication" --description "Implements login/logout functionality. Closes #123"
+# MR の状態確認
+glab mr list
+# MR のURLを開く
+glab mr view --web
+```
+**Web UIでの作成**:
+- GitHub: リポジトリページで "Compare & pull request" ボタン
+- GitLab: リポジトリページで "Create merge request" ボタン
+**PR/MR テンプレートの記入**:
+- [ ] 変更内容の説明
+- [ ] 影響範囲
+- [ ] テスト結果
+- [ ] スクリーンショット（UI変更の場合）
+- [ ] レビュワーの指定
+- [ ] ラベルの設定
+- [ ] マイルストーンの設定（必要に応じて）
+### 10. CI/CD の監視
+**CI/CD パイプラインの確認**:
+- GitHub Actions: リポジトリの "Actions" タブ
+- GitLab CI/CD: リポジトリの "CI/CD > Pipelines"
+**確認項目**:
+- [ ] すべてのジョブが成功している
+- [ ] テストが通過している
+- [ ] ビルドが成功している
+- [ ] デプロイが成功している（該当する場合）
+**CI失敗時の対応**:
+1. ログを確認してエラー原因を特定
+2. ローカルで再現して修正
+3. 修正をコミット・プッシュ
+4. CI が成功するまで繰り返す
+### 11. チームへの通知
+**通知方法**:
+- Slack / Microsoft Teams / Discord へ通知
+- メール通知
+- プロジェクト管理ツール（Jira, Asana等）への更新
+**通知内容**:
+- 変更内容の概要
+- PR/MR のURL
+- 影響範囲
+- レビュー依頼
+- テスト結果
+## 完了条件
+- ローカルブランチがリモートリポジトリにプッシュされている
+- テスト・Lint・CI が成功している
+- Pull Request / Merge Request が作成されている（該当する場合）
+- 必要なドキュメント更新・Issueリンク・レビュー依頼が整備されている
+- チームへの通知が完了している
+## エスカレーション
+- **プッシュが失敗する**:
+  - 認証情報を確認（PAT, SSH鍵）
+  - リモートURLを確認
+  - プッシュ権限を確認
+  - ネットワーク接続を確認
+- **プッシュ後のCIが失敗する**:
+  - ログを確認して原因を特定
+  - ローカルで再現して修正
+  - 対応が難しい場合はチームリードへ報告
+- **コンフリクトが解消できない**:
+  - ベースブランチの変更を確認
+  - コンフリクトファイルを手動マージ
+  - チームメンバーと調整
+- **セキュリティやコンプライアンスの問題**:
+  - セキュリティチームへ報告
+  - レビュープロセスに従う
+  - 必要に応じて変更を取り下げ
+## ベストプラクティス
+- **小さく頻繁にコミット**: 大きな変更は複数のコミットに分割
+- **意味のあるコミットメッセージ**: 変更内容が分かりやすいメッセージ
+- **テストを先に実行**: プッシュ前に必ずテストを実行
+- **ドキュメントを更新**: 変更に伴うドキュメント更新を忘れない
+- **レビューを依頼**: 重要な変更は必ずレビューを受ける
+- **CI/CDを監視**: プッシュ後のCI/CD結果を確認
+- **main/masterへの直接プッシュを避ける**: ブランチ戦略に従う
+- **強制プッシュは慎重に**: `--force-with-lease` を使用し、共有ブランチでは避ける
+## 参考: プラットフォーム別の機能
+**GitHub**:
+- Pull Request (PR)
+- GitHub Actions (CI/CD)
+- GitHub Projects (プロジェクト管理)
+- GitHub Discussions (ディスカッション)
+- GitHub CLI: `gh`
+**GitLab**:
+- Merge Request (MR)
+- GitLab CI/CD
+- GitLab Issues (課題管理)
+- GitLab Wiki (ドキュメント)
+- GitLab CLI: `glab`
+**共通機能**:
+- ブランチ保護
+- コードレビュー
+- CI/CD パイプライン
+- Issue/課題管理
+- Wiki/ドキュメント
+- Webhooks
+- API アクセス

package/.windsurf/workflows/x-Repository-PushToGithub.md ADDED Viewed

@@ -0,0 +1,72 @@
+---
+description: ローカル変更を検証し、安全なコミットとGitHubへのプッシュを行うための手順
+auto_execution_mode: 1
+---
+# Repository-PushToGithub (x-Repository-PushToGithub)
+## 目的
+- ローカル変更をレビュー・テストした上で、適切なブランチ運用とコミットメッセージで GitHub にプッシュする。
+- コンフリクトやCI失敗を未然に防ぎ、チームと共有できる状態で提出する。
+- 必要なドキュメンテーション更新や追跡情報を整備した上で変更を公開する。
+## 前提
+- ローカルリポジトリが GitHub 上のリモート（origin）と接続されている。
+- コミット対象の変更内容を把握しており、未保存ファイルや不要な変更がない。
+- 動作確認に必要なテストやビルドコマンドが `run_command` で実行でき、依存ツールが揃っている。
+- 認証情報（PAT / SSH鍵など）が有効で、GitHub への push 権限がある。
+- プッシュ前に README / ドキュメント / ワークフローを更新する必要がある場合は、その方針を決めている。
+## 手順
+1. **最新状態への同期**
+   - `git status` で変更状況を確認する。
+   - ベースブランチを最新化する (`git fetch --prune`)。
+   - 作業ブランチにチェックアウトし、必要であれば `git rebase origin/<base>` または `git merge origin/<base>` を実施する。
+2. **ローカル検証**
+   - 影響範囲に応じて lint、静的解析、ユニットテスト、E2Eテストなどを `run_command` で実行する。
+   - Playwright MCP や Chrome DevTools MCP が必要な場合は挙動確認を行い、スクリーンショット・ログを取得する。
+   - エラーが出た場合は修正し、再実行して成功を確認する。
+3. **変更内容の整理とコミット準備**
+   - `git status`・`git diff` を確認し、不要ファイルが含まれていないかチェックする。
+   - 粒度が大きすぎる場合はコミット単位を分割する。
+   - `git add` でコミット対象をステージし、`git diff --staged` で最終確認を行う。
+   - コミットメッセージはチーム規約（例: Conventional Commits）に従って作成する。
+4. **ドキュメントとメタ情報の更新**
+   - 変更に伴い README、CHANGELOGなどを更新する必要があれば反映する。
+   - Issue やタスク管理ツールとの関連を明記（コミット本文に `Fixes #123` 等）。
+5. **コミットの実行**
+   - `git commit` を実行し、メッセージを確定する。
+   - 過去コミットの修正が必要な場合は `git commit --amend` や `git rebase -i` を利用し、履歴を整える。
+6. **プッシュ前の最終確認**
+   - `git status` が clean であること、不要な stash が残っていないことを確認する。
+   - 直前にベースブランチへ変更が入っていないか `git fetch` で確認し、必要なら再度リベースする。
+7. **GitHub へのプッシュ**
+   - `git push origin <branch>` を実行する。
+   - 初回プッシュでブランチが存在しない場合は `-u` オプションで追跡ブランチを設定する。
+   - プッシュ結果を確認し、エラーがあればログに基づいて対処する。
+8. **フォローアップ**
+   - Pull Request を作成する場合はテンプレートに沿って記入し、レビュワー・ラベルを設定する。
+   - CI/CD の結果を監視し、失敗があれば原因を調査する。
+   - 必要に応じてチームへ通知し、変更内容・影響範囲・テスト状況を共有する。
+## 完了条件
+- ローカルブランチが GitHub にプッシュされ、変更内容が共有可能な状態になっている。
+- テスト・Lint・CI が成功している（または合理的な理由とともに失敗を説明している）。
+- 必要なドキュメント更新・Issueリンク・レビュー依頼が整備されている。
+## エスカレーション
+- プッシュ後のCIが失敗した場合、速やかに原因を確認し修正する。対応が難しい場合はチームリードへ報告する。
+- コンフリクトが解消できない場合や、ベースブランチ側の大規模変更が原因で作業が停滞した場合は、関係者と調整する。
+- セキュリティやコンプライアンスに影響する変更を含む場合は、セキュリティチームやレビュープロセスに従う。

package/.windsurf/workflows/x-Requirements-Clarify.md ADDED Viewed

@@ -0,0 +1,61 @@
+---
+description: あいまいな要求や仕様を整理し、補足質問と前提確認を体系化して共有するためのクラリフィケーションワークフロー
+auto_execution_mode: 1
+---
+# Requirements-Clarify (x-Requirements-Clarify)
+## 目的
+- 初期要求や仕様ドラフトの不明点・矛盾・前提不足を迅速に洗い出し、確かな理解を得る。
+- 機能・非機能・制約・リスクを観点別に整理し、意思決定者へ明確な質問セットを提示する。
+- 想定されるユースケースと除外範囲を明文化し、後続の設計・実装フェーズをスムーズに開始する。
+## 前提
+- 対象プロジェクトのリポジトリ／仕様資料へアクセスでき、関連ドキュメントを参照できること。
+- README、開発ガイドライン、既存ワークフローが最新状態であることを確認する。
+- 要求元が回答可能なコンタクト手段（Issue, PR, チャット等）が明確で、質問の優先度や回答期限を設定できること。
+- 高機密情報を扱う場合は、組織の情報セキュリティポリシーに従い共有範囲を制限する。
+## 手順
+1. **コンテキスト収集**
+   - 依頼メッセージ、既存の仕様書、議事録、関連する Issue/PR を読み込み、現時点で提示されている情報源をリスト化する。
+   - `run_command` や MCP（Context7, DeepWiki など）を利用し、関連ドキュメントやコード断片を検索する。
+2. **要求の要約とゴール仮説の作成**
+   - 要求の目的・背景・成功指標を 3〜5 行で短く要約し、現時点の理解（What / Why / For whom）を明文化する。
+   - 既知の制約（スケジュール、技術スタック、依存サービスなど）と前提をリスト化する。
+3. **ギャップと不確定要素の抽出**
+   - 機能要件、非機能要件、データ要件、UX 要件、運用要件など観点別に、不足情報・矛盾・曖昧表現を列挙する。
+   - 過去事例や類似プロジェクトの知見から想定されるリスクや特殊ケースを付記する。
+4. **検証と補足調査**
+   - 重要度が高い項目についてはコードベースやドキュメントを確認し、既存実装との整合性や影響を下調べする。
+   - ブラウザやAPIの現状挙動を再確認する必要があれば Playwright MCP や Chrome DevTools MCP で挙動を収集する。
+5. **質問リストと仮定の整理**
+   - 優先度（High/Medium/Low）を付けて質問をグルーピングし、回答が必要な理由や想定される選択肢を明記する。
+   - 回答を待つ間に採用した暫定的な仮定や推奨案を併記し、回答後のアクションもセットで提示する。
+6. **サマリーと次のアクション提示**
+   - 要約、主要な不確定点、質問リスト、暫定方針、推奨タイムラインを 1 ページ以内にまとめる。
+   - コミュニケーション手段（Issue コメント、PR、専用チャンネル等）に合わせた形式で共有し、回答期限とフォローアップ方法を明確化する。
+7. **フォローアップとドキュメント化**
+   - 回答が得られた項目を更新し、仕様ドキュメントやワークフローの関連セクションへ反映する。
+   - 未回答項目・保留事項を TODO として登録し、スプリント計画や backlog に連携する。
+## 完了条件
+- 仕様理解のサマリーと明確な質問リストが作成・共有され、回答期限や次ステップが合意されている。
+- 回答済み項目に基づき仕様ドキュメントが更新され、仮定や暫定決定が明文化されている。
+- 未解決事項が TODO として管理され、責任者とフォローアップ方法が設定されている。
+## エスカレーション
+- 重要な不明点が解消できずスケジュールや品質に重大な影響が出る場合は、プロダクトオーナーやステークホルダーへ早期に報告する。
+- セキュリティ・法務・プライバシーに関わる疑問が発生した場合は、専門チームへ確認し自己判断で進めない。
+- コミュニケーションが滞った場合は、チームリードやマネージャーへ状況を共有し、回答者の調整を依頼する。

package/.windsurf/workflows/z-CreateWorkflow.md ADDED Viewed

@@ -0,0 +1,77 @@
+---
+description: 新規ワークフローを作成するときに、目的・前提・手順・品質チェック・公開・フィードバックまでを標準化し、再利用性とガバナンスを担保するための手順書
+auto_execution_mode: 1
+---
+# /create-workflow
+## 目的
+- Windsurfリポジトリに新しいワークフローを追加する際の手順を標準化し、作業のばらつきを抑える。
+- READMEとベストプラクティスの方針を反映し、再利用可能なドキュメントを素早く整備する。
+## 前提
+- 作成先リポジトリが`.windsurf/workflows/`配下でMarkdown運用されていること（@README.md）。
+- Cascadeが利用可能なツール・Rules・Memoriesの権限を把握していること（@slash-commands-best-practices.md）。
+- 追加するワークフローの目的・対象ユーザー・完了条件が依頼元から共有済みであること。
+## 手順
+1. 情報収集
+   - 依頼文や関連資料を確認し、ワークフローの目的と制約を整理する。必要に応じて依頼元へ質問する。
+   - `@README.md`と`@slash-commands-best-practices.md`を読み、最新ポリシー・命名規約・文字数上限（12,000文字）を再確認する。
+2. スラッグとスコープを決定
+   - ファイル名は用途が即座に想起できる短いスラッグにする（例: `build-and-test.md`）。
+   - コマンド名(`/slug`)と対象範囲が一意であるか調査し、重複・競合があれば整理する。
+3. 作成テンプレートの準備
+   - セクション例: 目的 / 前提 / 手順 / 完了条件 / エスカレーション。必要に応じて入力仕様・参考リンク・検証項目を追加する。
+   - YAML frontmatterは使用せず、Markdown本文のみで構成する。
+4. 手順の詳細化
+   - 各ステップは番号付きまたは箇条書きで、Cascadeに期待するアクションと意図を明示する。
+   - 分岐は「IF ... THEN ...」、反復は「FOR EACH ...」など自然言語構文で記述し、曖昧な表現を避ける。
+   - CLIやMCPツールを利用する場合は名称と目的を明記し、権限や安全策が必要ならRules/Memoriesへの依存を記述する。
+5. コンテキスト最適化と参照設計
+   - 長文資料は`@path/to/doc.md`形式で参照し、ワークフロー内テキストは必要最小限に保つ。
+   - 他ワークフローを再利用する場合は「Call /workflow-name」と明記し、チェイン構築を想定した粒度に分割する。
+6. 品質チェック
+   - 以下を確認し、未達の場合は修正する。
+     - コマンド名と目的が直感的か。
+     - コンテキスト制限を満たし、冗長表現がないか。
+     - 依存ツール・前提条件・エスカレーション手順が明示されているか。
+     - 成功判定・完了報告フォーマットが定義されているか。
+     - セキュリティや権限に関する注意点が必要に応じて記載されているか。
+7. レビューと公開
+   - 変更差分をセルフレビューし、必要ならチームレビューを依頼する。
+   - `.windsurf/workflows/slug.md`を追加し、`git status`で不要な変更が含まれていないことを確認する。
+   - READMEへ新しいワークフローの概要やリンクを追記する場合は同時に更新する。
+   - テストや検証が必要なら実施し、得られたフィードバックを反映する。
+8. フィードバックループ
+   - 利用者からの改善提案を記録し、定期的に`@slash-commands-best-practices.md`へ反映を検討する。
+   - 重複内容が生じた場合は統合・再編を検討し、DRY原則を維持する。
+## 完了条件
+- 新規ワークフローMarkdownが目的・前提・明確な手順・完了報告を備えている。
+- READMEや関連資料に必要な追記が完了し、差分がレビュー可能な状態である。
+- 依頼元へ成果物と差分を共有し、レビュー結果待ちの状態になっている。
+## エスカレーション
+- ツール権限や安全性が不明な場合は、依頼元またはリポジトリ管理者に確認し、自律的な推測で危険な操作を行わない。
+- 既存ルールや他ワークフローと競合が判明した場合は、ガバナンス担当へ相談し調整する。