アジャイルワークフローオーケストレータ

エージェントを構造化されたアジャイル開発ワークフローを通じてガイドするスキルで、コマンドをインテリジェントに順序立てて実行します。チェックポイントベースのフロー制御を使用して、ステップ間を自動的に進行させながら、主要な決定ポイントで一時停止します。

注記: これはプラットフォーム非依存のgitのみのワークフローです。特定のプラットフォームを使用したPRベースのワークフローについては、以下を使用してください:

• gitea-workflow - Giteaリポジトリ用
• github-agile - GitHubリポジトリ用

このスキルを使用する場合

以下の場合にこのスキルを使用してください:

• 1日の作業を開始するとき(「morning standupを実行」、「今日を始める」)
• タスクに取り組むとき(「次のタスクを実装」、「作業を続ける」)
• 開発サイクルを完了するとき(「このタスクを完了」、「PRを準備」)
• スプリント儀式を実行するとき(「スプリントを開始」、「スプリントを終了」、「レトロスペクティブ」)
• 中断された作業を再開するとき(「次は何」、「どこまでやってた」)

このスキルを使用しないでください:

• 単一の特定のコマンドを実行する場合(そのコマンドを直接使用)
• ステータスをチェックするだけの場合(/statusを直接使用)
• 完全なサイクルなしでコードレビューのみを行う場合(/review-codeを直接使用)
• 実装なしで調査や計画を行う場合

前提条件

このスキルを使用する前に:

• Gitリポジトリ がworktreeサポートで初期化されていること
• コンテキストネットワーク が context-network/backlog/ に バックログ構造を持っていること
• タスクステータスファイルが context-network/backlog/by-status/*.md にあること

ワークフロータイプの概要

WORKFLOW TYPES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TASK CYCLE (Primary)     DAILY                SPRINT
──────────────────────   ──────────────────   ──────────────────
sync                     Morning:             Start:
  ↓                        sync --last 1d       sync --all
next → [CHECKPOINT]        status --brief       groom --all
  ↓                        groom --ready        plan sprint-goals
implement                                       status
  ↓                      Evening:
[CHECKPOINT]               checklist          End:
  ↓                        discovery            sync --sprint
review-code                sync --last 1d       retrospective
review-tests                                    audit --sprint
  ↓                                             status --metrics
[CHECKPOINT]                                    maintenance --deep
  ↓
apply-recommendations (if issues)
  ↓
merge-prep → [CHECKPOINT]
  ↓
merge-complete
  ↓
update-backlog & status
  ↓
END
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

状態検出

スキルは現在のワークフロー状態を自動的に判断します。手動での追跡は不要です。

検出シグナル

シグナル	確認方法	示すこと
Worktreeが存在	git worktree list	タスク進行中
タスクブランチがアクティブ	git branch --show-current が task/* と一致	アクティブな実装
コミットされていない変更	git status --porcelain	アクティブなコーディング
ブランチがマージ済み	git branch --merged main	マージ準備完了

状態マトリックス

STATE DETECTION LOGIC
─────────────────────────────────────────────────────────────
確認事項                           → 状態           → 次のステップ
─────────────────────────────────────────────────────────────
worktreeなし、進行中なし           → IDLE            → sync、next
worktreeあり、コミットされていない → IMPLEMENTING    → 実装を続ける
worktreeあり、すべてコミット済み   → READY_REVIEW    → review-code
レビュー完了、マージ準備完了      → MERGE_READY     → merge-prep
ブランチマージ済み、worktreeあり  → CLEANUP         → merge-complete
─────────────────────────────────────────────────────────────

詳細な検出アルゴリズムについては、references/state-detection.mdを参照してください。

呼び出しパターン

# 状態を自動検出して、現在地から続ける
/agile-workflow

# 特定のワークフローフェーズを開始
/agile-workflow --phase task-cycle
/agile-workflow --phase daily-morning
/agile-workflow --phase daily-evening
/agile-workflow --phase sprint-start
/agile-workflow --phase sprint-end

# 特定のタスクの作業を再開
/agile-workflow --task TASK-123

# 実行せずに何が起こるかをプレビュー
/agile-workflow --dry-run

タスクサイクルフェーズ

選択からマージまでの単一タスクを完了するための主要なワークフロー。

ステップ1: リアリティ同期

コンテキストネットワークが実際のプロジェクト状態と一致することを確認します。

実行: sync --last 1d --dry-run
目的: ドキュメント化された状態と実際の状態の乖離を検出
出力: 完了、部分的な作業、相違を示す同期レポート

ステップ2: タスク選択

次に取り組むタスクを特定します。

実行: next
目的: 最も優先度の高い準備完了タスクを検索
出力: タスクID、タイトル、ブランチ名の提案

チェックポイント: TASK_SELECTED

• タスク選択を確認するために一時停止
• ユーザーは受け入れるか別のタスクを選択できます
• 受け入れ時: 実装に続行

ステップ3: 実装

分離されたworktreeでテスト駆動開発を行います。

実行: implement [TASK-ID]
目的: worktreeを作成し、テストを最初に書き、実装し、検証
出力: テストがすべてパスしている作業中の実装

チェックポイント: IMPL_COMPLETE

• 実装完了後に一時停止
• テスト結果とカバレッジを表示
• 成功時: レビューに続行

ステップ4: レビュー

実装の品質検証。

実行: review-code --uncommitted
実行: review-tests --uncommitted
目的: 品質の問題、セキュリティ上の懸念、テストギャップを特定
出力: 問題と推奨事項を含むレビューレポート

チェックポイント: REVIEWS_DONE

• 結合されたレビュー結果を表示
• 重大な問題がある場合: 続行する前に対処する必要があります
• 問題がない場合: PR準備に自動的に続行
• ユーザーが判定: 今すぐ推奨事項を適用するか後で延期するか

ステップ5: 推奨事項を適用(条件付き)

レビュー結果をインテリジェントに対処します。

実行: apply-recommendations [review-output]
目的: 今すぐクイックフィックスを適用し、複雑な変更はタスクに延期
出力: 適用されたフィックス + 作成されたフォローアップタスク

ステップ6: マージを準備

検証とマージ前の準備をします。

実行: merge-prep
目的: 実装を検証し、最終チェックを実行し、マージを準備
出力: メインにマージする準備完了

チェックポイント: MERGE_READY

• 検証結果を表示
• マージされるファイルを表示
• すべてのチェックがパスした場合: マージに続行
• 失敗時: 停止し、問題を対処

ステップ7: マージ完了

メインにマージしてクリーンアップします。

実行: merge-complete
目的: メインにマージ、ブランチ削除、worktreeを削除、ステータス更新
出力: タスク完了とマーク、クリーンアップ完了

ステップ8: バックログとプロジェクトステータスを更新

進行状況を信頼できるドキュメントに保存します。

実行: merge-completeの一部(フェーズ6)
目的: エピックファイルを更新(タスク→完了)、依存するタスクをアンブロック、プロジェクトステータスを更新
出力: バックログとプロジェクトステータスが実際の進行状況を反映

このステップが重要な理由: これなしでは、完了したタスクはバックログファイルで「準備完了」のままマークされ、プロジェクトステータスは古い状態のままです。内部追跡ファイルはセッション対象ですが、バックログとステータスファイルは永続的な信頼できるソースです。

詳細なタスクサイクル手順については、references/phases/task-cycle.mdを参照してください。

デイリーフェーズ

1日の開始と終了のためのクイック実行シーケンス。

朝のスタンドアップ(~5分)

実行シーケンス:
1. sync --last 1d --dry-run   # 実際に昨日起こったこと
2. status --brief --sprint    # 現在のスプリントの健全性
3. groom --ready-only         # 作業する準備ができているもの

出力: 今日の優先事項の明確なイメージ

夕方のまとめ(~10分)

実行シーケンス:
1. checklist                  # 何も失われていないことを確認
2. discovery                  # 学習内容を把握
3. sync --last 1d            # タスクステータスを更新

出力: 知識が保存され、状態が同期される

詳細なデイリー手順については、references/phases/daily.mdを参照してください。

スプリントフェーズ

スプリント境界の儀式。

スプリント開始(~60分)

実行シーケンス:
1. sync --all                 # 完全なリアリティ調整
2. groom --all               # 包括的なグルーミング
3. plan sprint-goals         # アーキテクチャとゴール
4. status --detailed         # ベースラインメトリクス

出力: グルーミング済み、準備完了のバックログを持つスプリント計画

スプリント終了(~90分)

実行シーケンス:
1. sync --sprint             # 最終スプリント同期
2. retrospective             # 学習内容を把握
3. audit --scope sprint      # 品質レビュー
4. status --metrics          # スプリントメトリクス
5. maintenance --deep        # コンテキストネットワークのクリーンアップ

出力: スプリント終了、学習内容をキャプチャ、次へ準備完了

詳細なスプリント手順については、references/phases/sprint.mdを参照してください。

チェックポイント処理

チェックポイントは人間の意思決定のための一時停止です。

チェックポイント動作

各チェックポイントで:

1. まとめ - 完了したばかりのこと
2. 表示 - 主要な結果と問題
3. 提示 - 次のステップ
4. 待機 - ユーザー入力

チェックポイント応答

応答	アクション
「continue」/「proceed」/「yes」	次のステップに進む
「stop」/「pause」	状態を保存し、ワークフローを終了
「back」	前のステップを再実行
「skip」	現在のステップをスキップ(注意して使用)
カスタム入力	次のステップのパラメータを調整する可能性

自動継続条件

条件が満たされると、一部のチェックポイントは自動的に継続できます:

チェックポイント	自動継続する場合
IMPL_COMPLETE	すべてのテストがパス、ビルドが成功
REVIEWS_DONE	重大または高重大度の問題がない
MERGE_READY	すべての検証チェックがパス

詳細なチェックポイント処理については、references/checkpoint-handling.mdを参照してください。

コマンドリファレンス

各ワークフローステップは埋め込みコマンド手順を使用します:

コマンド	リファレンス	目的
sync	references/commands/sync.md	リアリティ同期
groom	references/commands/groom.md	タスク改善
next	references/commands/next.md	タスク選択
implement	references/commands/implement.md	TDD実装
review-code	references/commands/review-code.md	コード品質レビュー
review-tests	references/commands/review-tests.md	テスト品質レビュー
apply-recommendations	references/commands/apply-recommendations.md	トリアージとフィックス適用
merge-prep	references/commands/merge-prep.md	マージ準備
merge-complete	references/commands/merge-complete.md	マージとクリーンアップ
discovery	references/commands/discovery.md	学習キャプチャ
retrospective	references/commands/retrospective.md	事後分析
maintenance	references/commands/maintenance.md	コンテキストネットワークのクリーンアップ

例: 完全なタスクサイクル

シナリオ: 1日の開始、次に利用可能なタスクを実装

呼び出し:

/agile-workflow --phase task-cycle

フロー:

Agent: 現在の状態を検出中...
       worktreeが見つかりませんでした、準備完了タスクをチェック中...

Agent: sync --last 1d --dry-runを実行
       [同期出力: 0個のドキュメント化されていない完了タスク]

Agent: nextを実行
       見つけました: TASK-042 - ユーザー環境設定エンドポイントを追加
       優先度: 高 | サイズ: 小 | ブランチ: task/TASK-042-preferences

       ╔═══════════════════════════════════════════╗
       ║  チェックポイント: タスク選択               ║
       ╠═══════════════════════════════════════════╣
       ║  選択: TASK-042                           ║
       ║  実装を進めますか?                        ║
       ║                                           ║
       ║  [continue] [stop] [other task]           ║
       ╚═══════════════════════════════════════════╝

ユーザー: continue

Agent: .worktrees/TASK-042/にworktreeを作成中
       implement TASK-042を実行
       [TDDで実装が進行中...]

       テスト: 12個パス
       カバレッジ: 87%
       ビルド: 成功

       ╔═══════════════════════════════════════════╗
       ║  チェックポイント: 実装完了               ║
       ╠═══════════════════════════════════════════╣
       ║  すべてのテストがパス、レビュー準備完了  ║
       ║  コードレビューに進みますか?             ║
       ║                                           ║
       ║  [continue] [stop]                        ║
       ╚═══════════════════════════════════════════╝

[フロー はレビュー、マージを通じて続行...]

制限事項

• 特定のバックログ構造を持つコンテキストネットワークが必要
• gitのみのワークフロー(PR統合なし - PR ワークフローの場合はgitea-workflowまたはgithub-agileを使用)
• シングルタスクフォーカス(並列タスク作業はオーケストレーションされない)
• ソロ開発または信頼できるチームの直接メインへのワークフロームに最適

関連スキル

• gitea-workflow - PR統合を含むGiteaリポジトリ用
• github-agile - PR統合を含むGitHubリポジトリ用
• skill-maker - agentskills.io仕様に従う新しいスキルを作成
• research-workflow - 実装前の調査タスク用