new-album

タスク

入力：$ARGUMENTS

必要なファイルとテンプレートをすべて含む、新しいアルバムのディレクトリ構造を作成します。

---

新規アルバムスキル

設定に基づいて、アルバムのディレクトリ構造全体を作成します。

ステップ 1：引数を解析する

想定される形式：

• <album-name> <genre> — 通常のアルバム
• <album-name> documentary <genre> — 実話／ドキュメンタリーアルバム（RESEARCH.md + SOURCES.md を作成）

例：

• sample-album electronic
• my-new-album hip-hop
• protest-songs folk
• the-heist documentary hip-hop

有効なジャンル：${CLAUDE_PLUGIN_ROOT}/genres/ の下にディレクトリがあるジャンルはすべて有効です。スラッグ形式（小文字、ハイフン区切り）を使用します。例：deep-house、crust-punk、k-pop、hip-hop。

ジャンルが有効かどうかを確認するには、${CLAUDE_PLUGIN_ROOT}/genres/{genre}/README.md が存在することを確認します。

解析ロジック：

1. 引数が 3 つで、2 番目が documentary の場合：アルバム = arg1、ジャンル = arg3、documentary = true
2. 引数が 2 つの場合：アルバム = arg1、ジャンル = arg2、documentary = false
3. 引数が 2 つで、どちらも有効なジャンルスラッグに一致しない場合：確認を求めます
4. 引数が 1 つのみ、または引数がない場合：ユーザーに尋ねます

解析後、documentary フラグが設定されていない場合は、次のように尋ねます： 「これはドキュメンタリー／実話アルバムですか？（調査とソースのテンプレートが追加されます）」

引数が不足している場合は、次のように尋ねます：

Usage: /new-album <album-name> <genre>
       /new-album <album-name> documentary <genre>

Example: /new-album sample-album electronic
         /new-album the-heist documentary hip-hop
         /new-album night-drive deep-house

Genre must match a directory under genres/ (use slug form: deep-house, crust-punk, etc.)

ステップ 2：MCP 経由でアルバムを作成する

create_album_structure(album_slug, genre, documentary) を呼び出します。テンプレートを含むディレクトリ構造全体が 1 回の呼び出しで作成されます。

• コンテンツディレクトリを {content_root}/artists/{artist}/albums/{genre}/{album-name}/ に作成します
• アルバムテンプレートを README.md としてコピーします
• tracks/ と promo/ ディレクトリをテンプレートとともに作成します
• ドキュメンタリーアルバム（documentary: true）の場合：RESEARCH.md と SOURCES.md も作成します
• {created: bool, path: str, files: [...]} を返します
• アルバムのスラッグがいずれかのジャンルですでに存在する場合（スラッグは全体で一意です）、既存のジャンルとパスを示すエラーを返します

注：音声ディレクトリとドキュメントディレクトリは作成されません（import-audio/import-art で必要になったときに作成されます）。

ステップ 3：確認する

次の内容を報告します：

Created album: {album-name}
Location: {album_path}

Files created:
- README.md (album template)
- tracks/ (empty, ready for track files)
- promo/ (social media copy templates)

Next steps:
  Option 1 - Interactive (Recommended):
    Run /bitwize-music:album-conceptualizer to design your album concept
    through the 7 Planning Phases.

  Option 2 - Manual:
    1. Edit README.md with your album concept
    2. Create tracks with /import-track or manually in tracks/

Tip: For OST/soundtrack albums with a mix of vocal and instrumental
tracks, the album-conceptualizer will ask about the vocal/instrumental
split per track. Set `instrumental: true` in track frontmatter for
instrumental tracks — they skip the lyrics workflow and go directly
to /bitwize-music:suno-engineer.

エラー処理

設定ファイルが見つからない場合：

Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.

無効なジャンルの場合：

Error: Invalid genre "{genre}"

No genre directory found at genres/{genre}/. Use a valid genre slug (e.g. hip-hop, deep-house, grindcore).
Check genres/INDEX.md for the full list.

アルバムがすでに存在する場合（ジャンルを問わず、スラッグは全体で一意です）：

Error: Album slug '{album-name}' already exists under genre '{existing-genre}': {existing_path}

Album slugs are unique across all genres — choose a different name, or
rename the existing album with /bitwize-music:rename.

テンプレートが見つからない場合：

Error: Templates not found. Is the plugin installed correctly?
Expected at: ${CLAUDE_PLUGIN_ROOT}/templates/

---

例

/new-album sample-album electronic

設定内容：

paths:
  content_root: ~/bitwize-music
artist:
  name: bitwize

結果：

Created album: sample-album
Location: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/

Files created:
- README.md (album template)
- tracks/ (empty, ready for track files)

Next steps:
  Option 1 - Interactive (Recommended):
    Run /bitwize-music:album-conceptualizer to design your album concept
    through the 7 Planning Phases.

  Option 2 - Manual:
    1. Edit README.md with your album concept
    2. Create tracks with /import-track or manually in tracks/

---

実話アルバム

ユーザーが、これがドキュメンタリーまたは実話アルバムだと言及した場合：

/new-album the-heist documentary hip-hop

create_album_structure(album_slug, genre, documentary=true) の呼び出しにより、テンプレートから RESEARCH.md と SOURCES.md が自動的に作成されます。

次の内容を報告します：

Created album: the-heist (documentary)
Location: ~/bitwize-music/artists/bitwize/albums/hip-hop/the-heist/

Files created:
- README.md (album template)
- RESEARCH.md (research template)
- SOURCES.md (sources template)
- tracks/ (empty, ready for track files)

---

よくある間違い

❌ してはいけないこと：ディレクトリを手動で作成する

誤り：

# Manual mkdir, config reading, template copying
cat ~/.bitwize-music/config.yaml
mkdir -p ~/music-projects/artists/bitwize/albums/...
cp templates/album.md ...

正しい方法：

# Single MCP call handles everything
create_album_structure(album_slug, genre, documentary)

MCP ツールは設定を読み込み、パスを解決し、ディレクトリを作成して、テンプレートを自動的にコピーします。

✅ すべきこと：適切なジャンルスラッグを使用する

genres/ の下にディレクトリがあるジャンルはすべて有効です。該当する最も具体的なジャンルを使用します：

/new-album my-album boom-bap        # has its own genre directory
/new-album my-album deep-house      # specific subgenre
/new-album my-album grindcore       # specific subgenre
/new-album my-album hip-hop         # broad category also works