project-workflow

Project Workflow Skill

プロジェクトのライフサイクル全体を自動化する、連携した9つのスラッシュコマンドです。アイデアの検証 → 計画 → 実行 → セッション管理 → コンテキストの保持 → リリースまでをサポートします。

時間の節約：プロジェクトのライフサイクルごとに35〜55分

インストール

マーケットプレイス：/plugin install project-workflow@jezweb-skills

手動：commands/*.md を ~/.claude/commands/ にコピーします

9つのコマンド

1. /explore-idea - 計画前のアイデア検討

使用する場面：計画の前に、技術スタックの検証、スコープ管理、調査が必要なアイデアがあるとき。

作成するもの：検証済みの決定事項を記載した PROJECT_BRIEF.md → /plan-project に引き継ぎます

時間の節約：10〜15分

---

2. /plan-project - プロジェクト計画ドキュメントの生成

使用する場面：要件が明確な新規プロジェクトを開始するとき、または /explore-idea の後。

作成するもの：IMPLEMENTATION_PHASES.md、SESSION.md、DATABASE_SCHEMA.md（必要な場合）、API_ENDPOINTS.md（必要な場合）、ARCHITECTURE.md

呼び出すもの：project-planning スキル

時間の節約：5〜7分

---

3. /plan-feature - 既存プロジェクトへの機能追加

使用する場面：SESSION.md と IMPLEMENTATION_PHASES.md がある既存プロジェクトに機能を追加するとき。

実行内容：project-planning スキルを使って新しいフェーズを生成し、番号を振り直して IMPLEMENTATION_PHASES.md に統合し、SESSION.md を更新します。

時間の節約：7〜10分

---

4. /wrap-session - セッション終了時のチェックポイント

使用する場面：コンテキストがいっぱいのとき（150kトークン超）、作業セッションの終了時、またはタスクを切り替える前。

実行内容：タスクエージェントがセッションを分析 → SESSION.md（進捗、Next Action、ブロッカー）を更新 → git チェックポイントコミット → 書式を整えた引き継ぎ概要を作成します。

時間の節約：2〜3分

---

5. /continue-session - セッション開始時のコンテキスト読み込み

使用する場面：新しいセッションを開始するとき、または /wrap-session のチェックポイント後。

実行内容：Explore エージェントが SESSION.md と計画ドキュメントを読み込み → git 履歴とセッション概要（フェーズ、進捗、Next Action、ブロッカー）を表示 → 必要に応じてファイルを開く → 続行の許可を求めます。

時間の節約：1〜2分

---

6. /workflow - 対話型ワークフローガイド

使用する場面：初めて利用するとき、どのコマンドを使うべきか分からないとき、またはすぐに参照したいとき。

実行内容：9つのコマンドすべてを表示 → 判断ツリーを使って状況に応じたガイダンスを提示 → 適切なコマンドの実行を提案します。

---

7. /release - リリース前の安全チェック

使用する場面：GitHub の公開リポジトリにプッシュする準備ができたとき、またはリリースを作成するとき。

8つのフェーズ：

1. 重大な安全性の確認（ブロッカー）：シークレットのスキャン（gitleaks）、個人情報を含むファイルの確認、git リモートの検証
2. ドキュメント（必須）：LICENSE、README（100語超）、CONTRIBUTING.md（500 LOC超）、CODE_OF_CONDUCT（1000 LOC超）
3. 設定：.gitignore、package.json、git ブランチの警告
4. 品質（ブロッカーではない）：ビルドテスト、npm audit、大容量ファイル（1MB超）
5. レポート：ブロッカー／警告／推奨事項と、安全にリリースできるかの判定 6-8. 自動修正と公開：問題を修正し、リリース準備コミットを作成。必要に応じて git タグと GitHub リリースを作成

時間の節約：10〜15分

---

8. /brief - コンテキスト保持ドキュメント

使用する場面：コンテキストをクリアする前に、今後のセッションに向けて重要な決定事項や要件を保持するとき。

作成するもの：現在の会話から抽出した情報を記載した docs/brief-[slug].md。

実行内容：会話を分析 → 開発対象、決定事項、技術的な詳細を抽出 → 整理された Markdown ファイルを作成 → 必要に応じて追跡用の GitHub issue を作成します。

時間の節約：3〜5分

---

9. /reflect - 運用ナレッジの記録

使用するタイミング：コンテキストを圧縮する前、重要な作業を完了した後、または価値のある学びが蓄積されたときです。

機能：会話を振り返る → 発見したワークフロー、学んだパターン、ツールの実行順序、行った修正を特定する → 各学びを適切な保存先（ルール、CLAUDE.md、スキル、ドキュメント）に振り分ける → 必要に応じて自動化（スクリプト、コマンド、カスタムエージェント）を提案する

主な機能：推論や意思決定が必要な場合、並列実行が有効な場合、または調査や探索を伴う場合に、プロセスをカスタムエージェントにすべきかどうかを検討します。

時間の節約：5～10 分

---

ワークフローの例

全体：/explore-idea → /plan-project → 作業 → /wrap-session → /continue-session → /plan-feature（必要に応じて）→ 繰り返す → /reflect → /release

簡易版（要件が明確な場合）：/plan-project → 作業 → /wrap-session → /continue-session → /release

コンテキストの保持：/brief（コンテキストをクリアする前）、/reflect（学びを記録）

補助コマンド：/workflow（ガイダンス）、/plan-feature（機能の追加）、/release（公開）

---

連携

project-planning：/plan-project と /plan-feature から呼び出されます（IMPLEMENTATION_PHASES.md、DATABASE_SCHEMA.md、API_ENDPOINTS.md を生成します）

project-session-management：/wrap-session と /continue-session 用の SESSION.md プロトコル

Claude Code エージェント：/wrap-session（Task エージェント）、/continue-session と /explore-idea（Explore エージェント）

---

コマンドの関連性

EXPLORATION PHASE
/explore-idea (optional)
    ↓
    Creates PROJECT_BRIEF.md
    ↓
PLANNING PHASE
/plan-project (reads PROJECT_BRIEF.md if exists)
    ↓
    Creates IMPLEMENTATION_PHASES.md + SESSION.md
    ↓
EXECUTION PHASE
Work on phases
    ↓
/wrap-session (when context full)
    ↓
    Updates SESSION.md, git checkpoint
    ↓
/continue-session (new session)
    ↓
    Loads SESSION.md, continues work
    ↓
/plan-feature (when need new features)
    ↓
    Adds phases to IMPLEMENTATION_PHASES.md
    ↓
Continue wrap → resume cycle
    ↓
CONTEXT PRESERVATION
/brief (before clearing context)
    ↓
    Creates docs/brief-[slug].md
    ↓
/reflect (capture learnings)
    ↓
    Routes knowledge to rules, docs, CLAUDE.md
    ↓
RELEASE PHASE
/release (when ready to publish)
    ↓
    Safety checks → GitHub release

HELPER
/workflow (anytime)
    ↓
    Interactive guidance

---

時間の節約の内訳

コマンド	節約できる時間	自動化されるタスク
/explore-idea	10～15 分	調査、検証、スコープ管理、技術スタックの評価
/plan-project	5～7 分	計画ドキュメントの生成、git のセットアップ、フェーズの構成
/plan-feature	7～10 分	機能の計画、フェーズへの統合、ドキュメントの更新
/wrap-session	2～3 分	SESSION.md の更新、git のチェックポイント、引き継ぎの概要
/continue-session	1～2 分	コンテキストの読み込み、git 履歴の確認、次のアクションの表示
/workflow	即時	ナビゲーション、意思決定ツリー、コマンドの選択
/release	10～15 分	シークレットのスキャン、ドキュメントの検証、ビルドのテスト、リリースの作成
/brief	3～5 分	コンテキストの抽出、意思決定の記録、Markdown の生成
/reflect	5～10 分	学びの抽出、ナレッジの振り分け、自動化の提案

**プロジェクトのライフサイクル全体での節約時間：**45～70 分

---

前提条件

すべてのコマンド：Claude Code CLI、git リポジトリ（推奨）

/plan-feature：既存の SESSION.md と IMPLEMENTATION_PHASES.md

/wrap-session、/continue-session：SESSION.md（/plan-project が作成）

/release：コミットのある git リポジトリ、package.json（Node.js）、リモート URL（公開する場合）

---

トラブルシューティング

/plan-project「No project description」：まず /explore-idea を使用するか、Claude とプロジェクトについて話し合ってください

/plan-feature「Prerequisites not met」：まず /plan-project を実行してください（SESSION.md と IMPLEMENTATION_PHASES.md が作成されます）

/wrap-session「No git repository」：git init を実行してください

/continue-session「SESSION.md not found」：/plan-project を実行してください

/release「Secrets detected」：.gitignore に追加し、git の履歴から削除してください

---

バージョン履歴

1.1.0（2026-01-11）

• コンテキスト保持用の /brief コマンドを追加
• 運用ナレッジの記録用の /reflect コマンドを追加
• /reflect が、推論を必要とするプロセス向けにカスタムエージェントを提案するようになりました
• コマンド総数：9

1.0.0（2025-11-12）

• 初回リリース
• 7 つの統合スラッシュコマンド
• プラグインマーケットプレイスでの配布
• plugin.json によるコマンドのバンドル

---

問題の報告：https://github.com/jezweb/claude-skills/issues | 作成者：Jeremy Dawes ([email protected]) | ライセンス：MIT