agile-workflow

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

コマンドを順番にインテリジェントに実行し、エージェントを構造化されたアジャイル開発ワークフローに沿って導くスキルです。チェックポイントベースのフロー制御を使用して、重要な意思決定ポイントでは一時停止しながら、各ステップを自動的に進めます。

注： これはプラットフォームに依存しない、Git のみを使用するワークフローです。特定のプラットフォーム向けの PR ベースのワークフローには、以下を使用してください。

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

このスキルを使用するタイミング

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

• その日の作業を始めるとき（「朝会を実行」「今日の作業を始める」）
• タスクに取り組むとき（「次のタスクを実装」「作業を続ける」）
• 開発サイクルを完了するとき（「このタスクを完了」「PR を準備」）
• スプリントのセレモニーを実施するとき（「スプリントを開始」「スプリントを終了」「振り返り」）
• 中断した作業を再開するとき（「次は何をする」「どこまで進んだ」）

以下の場合はこのスキルを使用しないでください。

• 特定のコマンドを 1 つだけ実行する場合（そのコマンドを直接使用してください）
• ステータスを確認するだけの場合（/status を直接使用してください）
• 全サイクルを実施せず、コードレビューだけを行う場合（/review-code を直接使用してください）
• 実装を伴わない調査や計画を行う場合

前提条件

このスキルを使用する前に、以下を準備してください。

• worktree のサポートが有効な Git リポジトリ
• 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
  ↓                                             maintenance --deep
[CHECKPOINT]
  ↓
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
─────────────────────────────────────────────────────────────
Check                           → State           → Next Step
─────────────────────────────────────────────────────────────
No worktree, no in-progress     → IDLE            → sync, next
Worktree exists, uncommitted    → IMPLEMENTING    → continue implement
Worktree exists, all committed  → READY_REVIEW    → review-code
Reviews complete, ready to merge→ MERGE_READY     → merge-prep
Branch merged, worktree exists  → CLEANUP         → merge-complete
─────────────────────────────────────────────────────────────

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

呼び出しパターン

# Auto-detect state and continue from where you are
/agile-workflow

# Start specific workflow phase
/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

# Resume work on specific task
/agile-workflow --task TASK-123

# Preview what would happen without executing
/agile-workflow --dry-run

タスクサイクルのフェーズ

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

ステップ 1：実際の状態を同期する

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

Run: sync --last 1d --dry-run
Purpose: Detect drift between documented and actual state
Output: Sync report showing completions, partial work, divergences

ステップ 2：タスクを選択する

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

Run: next
Purpose: Find highest priority ready task
Output: Task ID, title, branch name suggestion

チェックポイント：TASK_SELECTED

• 一時停止してタスクの選択を確認します
• ユーザーは選択したタスクを承認するか、別のタスクを選べます
• 承認されたら、実装を続行します

ステップ 3：実装する

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

Run: implement [TASK-ID]
Purpose: Create worktree, write tests first, implement, verify
Output: Working implementation with passing tests

チェックポイント：IMPL_COMPLETE

• 実装完了後に一時停止します
• テスト結果とカバレッジを表示します
• 成功したら、レビューに進みます

ステップ 4：レビューする

実装の品質を検証します。

Run: review-code --uncommitted
Run: review-tests --uncommitted
Purpose: Identify quality issues, security concerns, test gaps
Output: Review reports with issues and recommendations

チェックポイント：REVIEWS_DONE

• レビュー結果をまとめて表示します
• 重大な問題がある場合：続行する前に必ず対処します
• 問題がない場合：PR の準備に自動的に進みます
• 推奨事項を今すぐ適用するか、後回しにするかはユーザーが決定します

ステップ 5：推奨事項を適用する（条件付き）

レビューで見つかった事項にインテリジェントに対処します。

Run: apply-recommendations [review-output]
Purpose: Apply quick fixes now, defer complex changes to tasks
Output: Applied fixes + created follow-up tasks

ステップ 6：マージを準備する

main へのマージを検証し、準備します。

Run: merge-prep
Purpose: Validate implementation, run final checks, prepare for merge
Output: Ready to merge to main

チェックポイント：MERGE_READY

• 検証結果を表示します
• マージされるファイルを表示します
• すべてのチェックに合格したら、マージに進みます
• 失敗した場合：停止して問題に対処します

ステップ 7：マージを完了する

main にマージし、クリーンアップします。

Run: merge-complete
Purpose: Merge to main, delete branch, remove worktree, update status
Output: Task marked complete, cleanup done

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

進捗を信頼できる一次資料に記録します。

Run: Part of merge-complete (Phase 6)
Purpose: Update epic file (task → complete), unblock dependents, update project status
Output: Backlog and project status reflect actual progress

このステップが重要な理由： このステップを実施しないと、完了したタスクがバックログファイルで「ready」のままになり、プロジェクトステータスも古い状態のままになります。内部の追跡ファイルはセッション単位ですが、バックログファイルとステータスファイルは永続的な信頼できる情報源です。

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

デイリーフェーズ

勤務日の開始時と終了時に実行する、短い手順です。

朝会（約 5 分）

Run sequence:
1. sync --last 1d --dry-run   # What actually happened yesterday
2. status --brief --sprint    # Current sprint health
3. groom --ready-only         # What's ready to work on

Output: Clear picture of today's priorities

夕方の振り返り（約10分）

Run sequence:
1. checklist                  # Ensure nothing lost
2. discovery                  # Capture learnings
3. sync --last 1d            # Update task statuses

Output: Knowledge preserved, state synchronized

毎日の詳しい手順については、references/phases/daily.mdを参照してください。

スプリントフェーズ

スプリントの開始時と終了時に行うセレモニーです。

スプリント開始（約60分）

Run sequence:
1. sync --all                 # Full reality alignment
2. groom --all               # Comprehensive grooming
3. plan sprint-goals         # Architecture and goals
4. status --detailed         # Baseline metrics

Output: Sprint plan with groomed, ready backlog

スプリント終了（約90分）

Run sequence:
1. sync --sprint             # Final sprint sync
2. retrospective             # Capture learnings
3. audit --scope sprint      # Quality review
4. status --metrics          # Sprint metrics
5. maintenance --deep        # Context network cleanup

Output: Sprint closed, learnings captured, ready for next

スプリントの詳しい手順については、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	コンテキストネットワークのクリーンアップ

例：タスクサイクル全体

シナリオ： 一日の始めに、次に対応可能なタスクを実装する

呼び出し：

/agile-workflow --phase task-cycle

フロー：

Agent: Detecting current state...
       No worktree found, checking ready tasks...

Agent: Running sync --last 1d --dry-run
       [Sync output: 0 tasks completed but undocumented]

Agent: Running next
       Found: TASK-042 - Add user preferences endpoint
       Priority: High | Size: Small | Branch: task/TASK-042-preferences

       ╔═══════════════════════════════════════════╗
       ║  CHECKPOINT: Task Selection               ║
       ╠═══════════════════════════════════════════╣
       ║  Selected: TASK-042                       ║
       ║  Proceed with implementation?             ║
       ║                                           ║
       ║  [continue] [stop] [other task]           ║
       ╚═══════════════════════════════════════════╝

User: continue

Agent: Creating worktree at .worktrees/TASK-042/
       Running implement TASK-042
       [Implementation proceeds with TDD...]

       Tests: 12 passing
       Coverage: 87%
       Build: Success

       ╔═══════════════════════════════════════════╗
       ║  CHECKPOINT: Implementation Complete      ║
       ╠═══════════════════════════════════════════╣
       ║  All tests passing, ready for review      ║
       ║  Proceed to code review?                  ║
       ║                                           ║
       ║  [continue] [stop]                        ║
       ╚═══════════════════════════════════════════╝

[Flow continues through review, merge...]

制限事項

• 特定のバックログ構造を持つコンテキストネットワークが必要です
• Git のみのワークフローです（PR 連携はありません。PR ワークフローには gitea-workflow または github-agile を使用してください）
• 単一タスクに焦点を当てています（並行タスク作業のオーケストレーションには対応していません）
• 個人開発、または信頼できるチームによる main への直接反映ワークフローに最適です

関連スキル

• gitea-workflow - PR 連携を使用する Gitea リポジトリ向け
• github-agile - PR 連携を使用する GitHub リポジトリ向け
• skill-maker - agentskills.io spec に従って新しいスキルを作成
• research-workflow - 実装前の調査タスク向け