Roadmap Next Task

SkillProductivity

Skill that starts the next incomplete task based on dependency order from the roadmap (`.agent/roadmap.md`). Consistently handles reflecting checkmarks upon completion, creating a plan first for tasks without an ExecPlan, and beginning implementation.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Roadmap Next Task skill

What this skill tells your AI

The instructions your AI receives, as published by modxcms-jp/evolution-jp in .claude/skills/roadmap-next-task/SKILL.md and read by ahel’s review.

.agent/roadmap.md をSSOTとして、次に着手すべきタスクを選定し、必要なら ExecPlan を作成してから実装に入る。 実装規約は AGENTS.md を最優先とする。 ロードマップ全体の追加・変更・削除や記述フォーマットの維持は roadmap-manager を使い、このスキルは「次タスク着手」に限定する。

実行ルール

  1. 正本は必ず .agent/roadmap.md を使う(assets/docs/roadmap.md は案内用途)。
  2. タスク選定は「実行順ロードマップ(依存順)」の上から順に行う。
  3. 既に実装と検証が完了し、ユーザー確認済みの作業を見つけた場合は、実装前にロードマップの完了状態を同期する。
  4. 着手対象タスクに ExecPlan が無い場合は、実装前に .agent/PLANS.md 準拠で新規作成する。
  5. ExecPlan がある場合でも、着手前に目的・進捗・検証条件を更新する。
  6. 実装と検証が完了したら、完了を告げてユーザー確認を求める。
  7. 完了処理の詳細は .agent/PLANS.md の「完了処理プロトコル」を正本とし、ユーザー確認後にのみ行う。

コマンド

/next-task

  1. すでに実装と検証が完了し、ユーザー確認済みなのに未同期の項目があれば、先に /sync-roadmap.agent/PLANS.md の「完了処理プロトコル」に従って反映する。
  2. .agent/roadmap.md の未完了項目を依存順で確認し、最上位の次タスクを1件特定する。
  3. 対象タスクに ExecPlan: 行があるか確認する。
  4. ExecPlan: 行が無いか値が なし の場合、.agent/plans/YYYY-MM-DD-task-name.md を作成し、該当タスクの ExecPlan: 行を更新する。
  5. 作成済み/新規の ExecPlan を更新し、最初の実装ステップを Progress に追加する。
  6. 実装に着手する。

/sync-roadmap

  1. 直近の実装結果・テスト結果から、実装と検証が完了し、ユーザー確認が取れた項目を抽出する。
  2. 抽出した項目は .agent/PLANS.md の「完了処理プロトコル」に従って完了同期を行う。
  3. 互換表示としてチェックボックスが残っている項目がある場合のみ整合させる。

/finish-task

  1. 対象 ExecPlan の ProgressValidation and Acceptance を完了状態に更新する。
  2. 実装と検証の完了を告げ、ロードマップ反映前にユーザー確認を求める。
  3. ユーザー確認後に /sync-roadmap を実行して、.agent/PLANS.md の「完了処理プロトコル」に従った完了同期を行う。
  4. 完了処理まで終えたことを告げ、未完了の次タスク候補を1件提示して終了する。

参照順(最小)

  1. AGENTS.md
  2. .agent/roadmap.md
  3. .agent/PLANS.md
  4. assets/docs/architecture.md(実装影響が大きいとき)

意思決定の閾値

自律判断可能:

  • 次タスクの機械的選定(依存順で先頭の未完了)
  • ExecPlan の有無判定と新規作成
  • ロードマップのチェック同期

要相談:

  • 優先順位の入れ替え
  • 複数タスク同時着手
  • ロードマップ項目そのものの追加・削除

Signals

GitHub stars
33
Forks
25
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
roadmap-next-task
Source
github.com/modxcms-jp/evolution-jp