spec-workflow-toolkit

CI/CD パイプラインの障害を体系的なログ分析と的確な修正で診断・解決する（必要条件: GitHub Actions 用の GitHub CLI 'gh'）

5つの並列スペシャリストエージェントによる信頼度ベースのスコアリングとフィルタリングを用いたコードレビュー（必要条件: PR レビュー用の GitHub CLI 'gh'）

体系的なデバッグワークフロー - エラー分析、根本原因の追跡、サブエージェント委任による修正実施

弁証法的探索による構造化マルチエージェントディスカッションをトピックについて開始する

ドキュメントとコードの乖離を監査 - 古くなったドキュメント、欠落セクション、不整合を検出

本番環境の緊急修正ワークフロー - 最小限のプロセスで最大限の安全性

git マージコンフリクトを体系的に解決する - 両バージョンを分析し、戦略を選択し、解決を検証する

プロジェクトを分析し、スタック検出とユーザーインタビューを通じて .claude/rules/ ファイルを生成する

完全な plan→review→implement フローが不要な、明確で小規模なタスクの迅速な実装

進捗ファイルから作業を再開する - コンテキストを復元し、最後のチェックポイントから継続

開発中にキャプチャされたインサイトをレビュー・承認する - インタラクティブに一つずつ処理

PR レビューコメントに対応する - フィードバックを分析し、変更を実装し、体系的に返信する（必要: GitHub CLI 'gh'）

承認済み仕様書と設計書に基づいて機能を実装する - ビルド、テスト、レビューを実施

仕様書ファーストの方法論で機能を計画する - 発見、探索、明確化、アーキテクチャ設計を反復的改善で実施

仕様書と設計書をユーザーとインタラクティブにレビュー・改善する - 承認されるまでフィードバックループを実施

実装後のユーザー変更リクエストを処理する - 仕様書/設計書に対する影響を分析し、適切なワークフローにルーティング

インタラクティブなスタックコンサルテーション: 要件ヒアリング、動的リサーチ、プロジェクトスキャフォールディング

あらゆるバックエンドスタックに対応するサーバーサイド実装のバックエンド開発スペシャリスト。 以下の場合に積極的に使用: - API、エンドポイント、サーバーサイド機能の実装 - Node.js、Python、Go、Rust、Java、その他のバックエンド技術での作業 - ビジネスロジック、サービス、データアクセス層の構築 - データベースの操作、クエリ、ORM操作 - サーバーサイドアーキテクチャやパフォーマンス最適化 トリガーフレーズ: バックエンド, API, エンドポイント, サーバー, データベース, クエリ, Node.js, Python, Go, Rust, Java, REST, GraphQL, サービス

既存のコードベースパターンに基づいた、確定的な実装ブループリントを提供する機能アーキテクチャ設計者。 以下の場合に積極的に使用: - 既存コードと統合が必要な新機能の設計 - 複雑な変更の実装戦略の計画 - 複数のコンポーネントに影響するアーキテクチャ上の決定 - 具体的なファイルパスを含む実装ロードマップの作成 トリガーフレーズ: 機能設計, アーキテクチャ計画, 実装ブループリント, どう実装すべきか, 設計アプローチ

実行パスの追跡、アーキテクチャ層のマッピング、パターンと抽象化の理解、file:line 参照による依存関係の文書化を行う、コードベース深層分析スペシャリスト。 以下の場合に積極的に使用: - 既存機能の動作理解（「Xはどう動くか？」「フローを追跡して」） - 未知のコードベースやモジュールの探索 - 機能やコンポーネントに関連するすべてのファイルの検出 - 依存関係やコールチェーンのマッピング - 変更実装前の影響範囲の理解 - アーキテクチャパターンと規約の分析 トリガーフレーズ: 探索, 追跡, どう動くか, すべて検索, 依存関係マッピング, 実行フロー, コールチェーン, コードベース理解, アーキテクチャ分析

あらゆるスタックに対応するインフラストラクチャ、デプロイメント、運用のためのサイト信頼性エンジニア。 以下の場合に積極的に使用: - Docker、Kubernetes、コンテナ化のセットアップ - CI/CDパイプラインの作成・変更（GitHub Actions、GitLab CI等） - インフラ設定やクラウドリソース管理 - モニタリング、ロギング、アラートのセットアップ - 本番デプロイメントや運用上の懸念 トリガーフレーズ: Docker, Kubernetes, CI/CD, パイプライン, デプロイ, インフラ, モニタリング, DevOps, SRE, コンテナ, Terraform

あらゆるフロントエンドスタックに対応するUI実装のフロントエンド開発スペシャリスト。 以下の場合に積極的に使用: - UIコンポーネント、ページ、クライアントサイド機能の実装 - React、Vue、Angular、Svelte、その他のフロントエンドフレームワークでの作業 - レスポンシブレイアウトの構築やユーザーインタラクションの処理 - フロントエンドアーキテクチャの決定や状態管理 - アクセシビリティ（a11y）の実装やレビュー トリガーフレーズ: フロントエンド, UI, コンポーネント, React, Vue, Angular, Svelte, CSS, スタイリング, レスポンシブ, アクセシビリティ, クライアントサイド

あらゆるスタックに対応するリバースエンジニアリング、特性テスト、安全なリファクタリングのためのレガシーコードスペシャリスト。 以下の場合に積極的に使用: - 古いコードやドキュメントのないコードのモダナイゼーションやリファクタリング - ドキュメントのない複雑なレガシーシステムの理解 - 既存の動作をキャプチャするための特性テストの作成 - マイグレーション戦略の計画（Strangler Figパターン等） - セーフティネット付きの大規模リファクタリング トリガーフレーズ: レガシー, モダナイズ, リファクタリング, 特性テスト, ドキュメントのないコード, リバースエンジニアリング, マイグレーション, 技術的負債

要件収集、PRD作成、仕様書作成のためのシニアテクニカルプロダクトマネージャー。 以下の場合に積極的に使用: - ユーザーリクエストが曖昧または不完全（「機能を追加して」「もっと良くして」） - 実装前の要件定義 - ユーザーインタビューやステークホルダー分析の実施 - ビジネスリクエストの技術仕様への変換 - PRDまたは仕様書の作成 トリガーフレーズ: 要件, PRD, 仕様, ユーザーストーリー, 受け入れ基準, スコープ定義, ステークホルダー

あらゆるスタックに対応するテストと品質保証のためのQA自動化エンジニア。 以下の場合に積極的に使用: - 新機能の実装やバグ修正の後 - ユニットテスト、インテグレーションテスト、E2Eテストの作成 - テスト戦略の策定やカバレッジの改善 - テストが失敗して調査が必要な場合 - コードマージ前の品質確保 トリガーフレーズ: テスト, ユニットテスト, インテグレーションテスト, E2E, カバレッジ, QA, 品質保証, テスト失敗, テスト戦略

コードレビュー、脆弱性評価、セキュリティベストプラクティスのためのセキュリティ監査人。 以下の場合に積極的に使用: - 本番デプロイ前またはクリティカルなコードのマージ前 - 認証、認可、データ処理の実装後 - ユーザー入力や機密データを扱うコードのレビュー - OWASPコンプライアンスチェックや依存関係監査の実施 - セキュリティに関わる変更が行われた場合 トリガーフレーズ: セキュリティレビュー, 脆弱性, OWASP, 監査, CVE, インジェクション, XSS, 認証セキュリティ, シークレット

ハイレベルなソフトウェア設計、データベーススキーマ、APIコントラクト、アーキテクチャ上の決定のためのシステムアーキテクト。 以下の場合に積極的に使用: - 新しいシステムや主要コンポーネントの設計（「システムを設計して」「ソリューションを設計して」） - データベーススキーマやデータモデルの作成 - APIコントラクトの定義（OpenAPI、GraphQL SDL、Protobuf） - 重要なアーキテクチャ上の選択（モノリス vs マイクロサービス等） - アーキテクチャ決定記録（ADR）の作成 注意: 既存パターンに基づく機能レベルの実装ブループリントには `code-architect` を使用してください。 トリガーフレーズ: システムアーキテクチャ, データベーススキーマ, APIコントラクト, ADR, 技術的決定, スケーラビリティ, マイクロサービス

あらゆるスタックに対応するドキュメント、変更履歴、APIドキュメントのためのテクニカルライター。 以下の場合に積極的に使用: - READMEファイルやドキュメントの作成・更新 - 変更履歴やリリースノートの生成 - APIドキュメントの作成（OpenAPI、GraphQLドキュメント） - アーキテクチャ決定の文書化（ADR） - ダイアグラムやテクニカルガイドの作成 トリガーフレーズ: ドキュメント, README, 変更履歴, APIドキュメント, リリースノート, ADR, テクニカルライティング, ユーザーガイド, ダイアグラム

あらゆるフロントエンドフレームワークに対応するデザインシステム、アクセシビリティ、ユーザーエクスペリエンスを専門とするUI/UXデザイナー。 以下の場合に積極的に使用: - コンポーネントデザインやデザインシステムの作成・変更 - アクセシビリティ（a11y）監査やWCAGコンプライアンスチェックの実施 - ユーザーフロー、ワイヤーフレーム、情報アーキテクチャの設計 - デザイントークン、カラースキーム、タイポグラフィスケールの確立 - UIの一貫性とユーザビリティのレビュー 注意: このエージェントはデザイン専用です。UI実装には frontend-specialist を使用してください。 トリガーフレーズ: デザインシステム, アクセシビリティ, a11y, WCAG, ワイヤーフレーム, ユーザーフロー, UX, UIデザイン, コンポーネントデザイン, カラーパレット

他のエージェントからの調査結果を、ファイル参照の検証、コード引用の確認、情報の整合性チェックを通じて検証するファクトチェックスペシャリスト。 以下の場合に積極的に使用: - 複数のエージェントからの調査結果がクロスバリデーションを必要とする場合 - file:line 参照の検証が必要な場合 - 引用されたコードスニペットの実際の内容との確認が必要な場合 - 外部リソースの推奨事項に依拠する前 - 並列エージェント実行からのレポートを統合する場合 トリガーフレーズ: 検証, ファクトチェック, 調査結果の検証, 参照の確認, クロスリファレンス, 正確性の確認

ルール遵守と創造的な問題解決のバランスを取るフレームワーク。 Use when: 複雑な判断、規範的すぎる指示の適応、精度と革新のバランス。 Trigger phrases: think creatively, use judgment, adapt approach, flexibility

曖昧なリクエストを明確にする構造化要件インタビュー。 Use when: 要件不明確、新機能開始時の要件収集、ビジネス→技術仕様変換。 Trigger phrases: gather requirements, clarify request, interview user, requirements gathering

すべてのユーザー向けコンテンツに日本語出力を強制。 Use when: エージェント出力の日本語化、言語の一貫性検証。 Trigger phrases: Japanese, 日本語, language mode, output language

あらゆる技術スタックに適用可能なコアセキュリティ原則。 Use when: 認証/認可実装、機密データ取り扱い、入力バリデーション、セキュリティレビュー。 Trigger phrases: security review, auth, password, input validation, XSS, SQL injection, CSRF, OWASP

仕様駆動開発（SDD）の方法論とワークフロー。 Use when: 新機能開始、曖昧な要件の明確化、仕様ファースト開発の強制。 Trigger phrases: specification, PRD, requirements document, scope definition, feature planning

オーケストレーターとサブエージェント間の標準通信プロトコル。 委任ルール、結果フォーマット、エラーハンドリングを定義。 Use when: コマンド作成、サブエージェント定義、結果集約、委任制約の理解。 Trigger phrases: subagent format, agent output, result format, orchestrator rules, delegation

設定ファイルとソースコードからプロジェクトの技術スタックを自動検出。 Use when: 新規コードベースでの作業開始、言語/フレームワーク/ツールの特定。 Trigger phrases: detect stack, what framework, identify technology, project setup

REST、GraphQL、gRPC の API 設計パターン。 Use when: API の新規設計、OpenAPI 仕様作成、バージョニング/ページネーション設計。 Trigger phrases: API design, REST endpoint, GraphQL schema, OpenAPI, gRPC, pagination

プロジェクト設定済みのリンティング・フォーマット・型チェックの検出と実行。 Use when: コード品質チェック、リントエラー修正、CI 品質チェック失敗時。 Trigger phrases: lint, format code, run linter, type check, code style

Agent Team によるマルチエージェント構造化ディスカッションプロトコル。 Use when: /discuss コマンド実行、設計判断の多角的議論、技術選定の合意形成。 Trigger phrases: discuss, deliberate, multi-perspective, team discussion

エラーハンドリング、チェックポイント、リカバリパターン。 Use when: 障害回復、チェックポイント設計、グレースフルデグラデーション、リトライ管理。 Trigger phrases: error handling, recovery, checkpoint, resume, graceful degradation, retry, fallback

エバリュエーター・オプティマイザーのフィードバックループによる反復改善。 Use when: 出力品質の反復改善、明確な評価基準がある複雑な出力の最適化。 Trigger phrases: iterate, refine, improve quality, feedback loop, evaluate and optimize

Conventional Commits、変更ログ管理、git ワークフロー。 Use when: コミットメッセージ作成、変更ログ管理、ブランチ/マージ操作、リカバリ。 Trigger phrases: commit message, conventional commits, changelog, git workflow, semantic version

開発インサイトを記録する標準マーカープロトコル。 Use when: パターン/アンチパターン発見、重要な判断記録、将来参照用インサイト。 Trigger phrases: PATTERN, ANTIPATTERN, LEARNED, DECISION, INSIGHT, insight marker

状態永続化と進捗トラッキングを伴う自律的ロングランニングタスクパターン。 Use when: 複数ステップタスク、セッション間の状態永続化、大規模マイグレーション。 Trigger phrases: long task, autonomous, persist state, track progress, migration, multi-step

ORM/データベース非依存の安全なスキーママイグレーションパターン。 Use when: スキーマ変更、安全なマイグレーション実行、ロールバック管理、リスク評価。 Trigger phrases: database migration, schema change, add column, migration rollback, schema drift

ロギング、メトリクス、分散トレーシングのオブザーバビリティパターン。 Use when: 構造化ロギング、メトリクス/モニタリング、分散トレーシング、ヘルスチェック。 Trigger phrases: logging, metrics, tracing, monitoring, health check, alerting, SLO

並列サブエージェント実行によるコンテキスト効率最大化パターン。 Use when: 複数独立タスクの同時実行、並列レビュー、多角的コードベース探索。 Trigger phrases: parallel review, concurrent agents, multi-agent, run simultaneously

ユーザー提示前のプラン品質ゲート（エージェント呼び出しなし）。 Use when: /spec-plan 最終出力の品質確認、仕様⇔設計の一貫性検証。 Trigger phrases: self review, plan quality, pre-review check

マルチセッションタスクのための JSON ベース進捗トラッキング。 Use when: 複雑なタスクの進捗追跡、セッション間の再開、大規模マイグレーション管理。 Trigger phrases: track progress, resume, continue, multi-session, persist state, progress file

動的リサーチによる新プロジェクト向け技術スタックコンサルテーション。 Use when: 新規プロジェクト開始、技術スタック選定、最新ベストプラクティスの推奨。 Trigger phrases: stack consultation, recommend stack, what technology, choose tools, new project

Red-Green-Refactor サイクルによるテスト駆動開発ワークフロー。 Use when: TDD での新機能実装、テストファーストのバグ修正、リファクタリング前のテスト。 Trigger phrases: TDD, test-driven, test first, red-green-refactor, write tests before code

Agent Team 並列レビュー・実装の協調プロトコル。 Use when: spec-review --auto のチームモード、複数エージェント並列レビュー。 Trigger phrases: agent team, team mode, parallel review team

技術的負債の特定、分類、優先順位付けフレームワーク。 Use when: 負債の特定・追跡、優先順位付け、リファクタリング計画、ステークホルダー報告。 Trigger phrases: tech debt, code smell, refactor priority, RICE score, debt tracking, legacy code

任意スタック向けのテスト戦略、パターン、ベストプラクティス。 Use when: テスト作成、テスト戦略策定、カバレッジ改善、フレーキーテスト対応。 Trigger phrases: write tests, unit test, integration test, E2E test, test coverage, mock, fixture

13 hooks across 8 events