next-step

あなたのタスク

入力：$ARGUMENTS（アルバム名は任意）

現在のプロジェクトの状態を分析し、次に行うべき最善のアクションを1つ提案します。

---

次のステップのアドバイザー

アルバムとトラックの現在の状態を分析し、次に行うべき最適なアクションを提案します。ワークフローのルーターとして、ユーザーが現在どの段階にいるかを判断し、次に何をすべきかを具体的に伝えます。

---

ロジック

アルバムが指定されていない場合

1. get_session() を呼び出し、セッションコンテキストから last_album を確認します
2. セッションに直近のアルバムがある場合は、get_album_progress(album_slug) を呼び出して分析します
3. セッションコンテキストがない場合は、list_albums() を呼び出してすべてのアルバムを取得し、各アルバムに対して get_album_progress() を呼び出して、最も次のアクションに移りやすいものを選びます
4. アルバムが存在しない場合は、アルバムを作成するよう提案します

アルバムが指定されている場合

1. find_album(name) を呼び出します。名前、スラッグ、または部分一致で検索します
2. get_album_progress(album_slug) を呼び出して、ステータス、フェーズ、トラック数を取得します
3. 検出したフェーズに基づいて、次のアクションを提案します

---

判断ツリー

アルバムとトラックのステータスを分析し、次に行うべき最適なアクションを判断します。

インストゥルメンタルの判定：各トラックのフロントマターに instrumental: true があるか、または Track Details テーブルに **Instrumental** | Yes があるかを確認します。インストゥルメンタルのトラックは歌詞のワークフロー（lyric-writer、pronunciation-specialist、lyric-reviewer）を省略し、直接 /bitwize-music:suno-engineer に進んで Style Box を作成します。

Album Status = "Concept"
  → "Define the album concept. Run the 7 Planning Phases with /bitwize-music:album-conceptualizer"

Album Status = "Research Complete"
  → Any tracks Sources Pending?
    YES → "Sources need verification. Review SOURCES.md and verify each source."
    NO  → First "Not Started" track instrumental?
      YES → "Create Style Box for instrumental track [name]. Use /bitwize-music:suno-engineer"
      NO  → "Ready to write! Pick a track and use /bitwize-music:lyric-writer"

Album has tracks with status "Not Started"
  → First not-started track instrumental?
    YES → "Create Style Box for instrumental track [name]. Use /bitwize-music:suno-engineer directly"
    NO  → "Write lyrics for track [first not-started track]. Use /bitwize-music:lyric-writer"

Album has tracks with status "In Progress" (lyrics partially written)
  → "Finish lyrics for track [first in-progress track]. Use /bitwize-music:lyric-writer"

Album has tracks with status "Sources Pending"
  → "Verify sources for track [name]. Check SOURCES.md, then update sources_verified field."

All tracks have lyrics (or Style Box for instrumentals), none generated
  → Has vocal tracks?
    YES → "Run /bitwize-music:pronunciation-specialist on vocal tracks, then /bitwize-music:lyric-reviewer for final QC, then /bitwize-music:pre-generation-check to validate all gates (instrumental tracks auto-skip lyrics gates)."
    NO (all instrumental) → "All Style Boxes ready! Run /bitwize-music:pre-generation-check to validate gates before generating on Suno."

Some tracks generated, some not
  → Any Generated tracks without ✓ in Generation Log Rating?
    YES → "Track [name] needs review. Listen and approve (mark ✓ in Generation Log) or regenerate.
           Style issue → /bitwize-music:suno-engineer to revise Style Box, then regenerate
           Lyrics issue → /bitwize-music:lyric-writer to fix lyrics, then regenerate
           Bad luck → Regenerate on Suno (non-deterministic, same settings may give better result)"
    NO  → "Generate track [first un-generated track] on Suno. Use /bitwize-music:suno-engineer"

All tracks generated, none Final
  → "All tracks generated! Review each track:
     Mark keepers with ✓ in Generation Log, regenerate rejected ones.
     Once all approved, batch-approve:
     Use update_track_field(album_slug, track_slug, 'status', 'Final') for each.
     Once all Final, album advances to Complete."

All tracks generated, some Final
  → Any Generated (non-Final) without ✓?
    YES → "Review track [name] — approve (✓) or regenerate"
    NO  → "All reviewed! Batch-approve remaining: update_track_field(album_slug, track_slug, 'status', 'Final') for each.
           Then import audio with /bitwize-music:import-audio, then master with /bitwize-music:mastering-engineer"

All tracks Final
  → "All tracks approved! Import audio with /bitwize-music:import-audio, then master with /bitwize-music:mastering-engineer"

Album Status = "Complete"
  → "Album is complete! Release with /bitwize-music:release-director"

Album Status = "Released"
  → "This album is released! Consider promotional content with /bitwize-music:promo-director"
  → Also suggest: "Start a new album? Check your ideas with /bitwize-music:album-ideas list"

---

出力形式

NEXT STEP
=========

Album: [name] ([genre]) — [status]
Progress: [X/Y tracks complete]

RECOMMENDED ACTION:
  [Clear, specific instruction with skill name]

WHY:
  [One sentence explaining why this is the right next step]

AFTER THAT:
  [Brief mention of what comes after this step]

複数のアルバムを分析する場合

アルバムが指定されておらず、複数のアルバムが存在する場合：

NEXT STEP
=========

You have X albums. Here's the most actionable:

PRIORITY 1: [album-name] ([genre])
  Status: [status] | Progress: [X/Y tracks]
  → [Recommended action]

Also in progress:
  - [album-2] — [brief status]
  - [album-3] — [brief status]

Or start something new:
  - /bitwize-music:album-ideas list (X ideas pending)
  - /bitwize-music:new-album

---

優先ルール

複数のアルバムが進行中の場合、次の順に優先します。

1. 完成に最も近いもの — 8トラック中7トラックが完了しているアルバムは、10トラック中2トラックのアルバムより優先します
2. 作業を進められるもの — ソース確認待ちのアルバムはブロックされていますが、歌詞が必要なアルバムはブロックされていません
3. 最後に作業したもの — 直近のセッションのアルバムを優先します（一貫性を保つため）
4. トラック数が多いもの — 規模の大きいアルバムほど、保護すべき投資が大きくなります

---

覚えておくこと

1. 明確な提案は1つだけ — 5つの選択肢を並べないでください。最善のものを選びます
2. スキル名を含める — 「歌詞を書く」ではなく「/bitwize-music:lyric-writer」とします
3. 対象のトラックを具体的に示す — 「歌詞を書く」ではなく「track 04-the-escape の歌詞を書く」とします
4. 理由を簡潔に説明する — 推薦の理由がわかれば、ユーザーは安心して従えます
5. resume の内容を繰り返さない — ユーザーが直前に resume を実行した場合、同じ情報を再表示しないでください