validate-album

Album Validator Agent

タスク

入力：$ARGUMENTS（アルバム名。例：sample-album）

アルバムに必要なすべてのファイルが正しい場所にあることを検証し、パスの問題やコンテンツの不足が問題になる前に検出します。

---

ステップ 1：設定を読み込み、アルバムを検索する

1. get_config() を呼び出します。パス（content_root、audio_root、documents_root）と artist.name が返されます。

   • 設定がない場合は停止し、次の内容を報告します。

     [FAIL] Config file missing: ~/.bitwize-music/config.yaml
            Run /configure to set up the plugin.
     

2. find_album(album_name) を呼び出します。名前、スラッグ、または部分一致であいまい検索します。

   • 見つからない場合は停止し、次の内容を報告します（MCP から利用可能なアルバムが返されます）。

     [FAIL] Album not found: {album-name}
     

3. 必要に応じて validate_album_structure(album_slug) を呼び出します。構造の検証を実行し、{passed, failed, warnings, skipped, issues[], checks[]} を返します。この MCP ツールは、ディレクトリ構造、必須ファイル、音声ファイルの配置、トラックの内容をまとめて確認します。

注：MCP の validate_album_structure ツールは、以下の確認項目の多くを自動で実行します。結果をそのまま使用することも、より詳細に報告するため手動で確認することもできます。

---

ステップ 3：検証を実行する

カウンターを初期化する

• passed = 0
• failed = 0
• warnings = 0
• skipped = 0
• issues = []（修正コマンドのリスト）

出力ヘッダー

═══════════════════════════════════════════════════════════
ALBUM VALIDATION: {album-name}
═══════════════════════════════════════════════════════════

---

検証カテゴリ

CONFIG

CONFIG
──────

確認項目	成功	失敗
設定ファイルが存在する	[PASS] Config file exists	[FAIL] Config file missing
content_root が定義されている	[PASS] content_root: {value}	[FAIL] content_root not defined
audio_root が定義されている	[PASS] audio_root: {value}	[FAIL] audio_root not defined
アーティストが定義されている	[PASS] artist: {value}	[FAIL] artist.name not defined

アルバム構造

ALBUM STRUCTURE
───────────────

確認項目	方法	成功	失敗
アルバムディレクトリが存在する	test -d {album_path}	[PASS] Album directory: {path}	[FAIL] Album directory missing
README.md が存在する	test -f {album_path}/README.md	[PASS] README.md exists	[FAIL] README.md missing
tracks/ ディレクトリが存在する	test -d {album_path}/tracks	[PASS] tracks/ directory exists	[FAIL] tracks/ directory missing
トラックファイルが存在する	ls {album_path}/tracks/*.md	[PASS] {N} track files found	[WARN] No track files found

ドキュメンタリーアルバムの場合（README.md で種類を確認）：

確認項目	方法	成功	失敗
RESEARCH.md が存在する	test -f {album_path}/RESEARCH.md	[PASS] RESEARCH.md exists	[WARN] RESEARCH.md missing (documentary album)
SOURCES.md が存在する	test -f {album_path}/SOURCES.md	[PASS] SOURCES.md exists	[WARN] SOURCES.md missing (documentary album)

音声ファイル

AUDIO FILES
───────────

想定されるパス：{audio_root}/artists/{artist}/albums/{genre}/{album}/

確認項目	方法	成功	失敗
音声ディレクトリが存在する（正しいパス）	test -d {audio_root}/artists/{artist}/albums/{genre}/{album}	[PASS] Audio directory: {path}	以下を参照
音声ディレクトリが間違った場所にある	test -d {audio_root}/{album}	該当なし	[FAIL] Audio in wrong location (missing artist folder)

音声ファイルが間違った場所にある場合、issues に追加します。

→ Expected: {audio_root}/artists/{artist}/albums/{genre}/{album}/
→ Found at: {audio_root}/{album}/ (WRONG - missing artist folder)
→ Fix: mv {audio_root}/{album}/ {audio_root}/artists/{artist}/albums/{genre}/{album}/

確認項目	方法	成功	スキップ
WAV ファイルがある	ls {audio_path}/*.wav	[PASS] {N} WAV files found	[SKIP] No audio files yet
mastered/ が存在する	test -d {audio_path}/mastered	[PASS] mastered/ directory exists	[SKIP] Not mastered yet

アルバムアート

ALBUM ART
─────────

確認項目	方法	成功	スキップ
音声フォルダーにアートがある	test -f {audio_path}/album.png	[PASS] album.png in audio folder	[SKIP] No album art yet
コンテンツフォルダーにアートがある	test -f {album_path}/album-art.*	[PASS] album-art in content folder	[SKIP] No album art yet

TRACKS

TRACKS
──────

{album_path}/tracks/*.md 内の各トラックファイルについて：

1. ファイルを読み取ります
2. 必須フィールドを確認します：
   • Status フィールドが存在する
   • Suno Style Box が存在する（## Suno Inputs セクションがある）
   • Suno Lyrics Box が存在する
   • Status が Generated または Final の場合：Suno Link が存在する
   • ドキュメンタリーの場合：Sources Verified ステータスを確認する
3. インストゥルメンタルフィールドの同期を確認します：
   • frontmatter の instrumental フィールドを読み取ります（true/false/未設定）
   • Track Details テーブルの **Instrumental** 行を読み取ります（Yes/No/未設定）
   • 両方が設定されていて値が一致しない場合 → [WARN] {filename} - Instrumental field mismatch: frontmatter={value}, table={value}
   • 一方のみが設定されている場合 → [WARN] {filename} - Instrumental field missing from {frontmatter|table} (set in {other})

トラックごとの出力：

• [PASS] {filename} - Status: {status}, Suno Link: {present/missing}
• [WARN] {filename} - Status: {status}, missing {what}
• [FAIL] {filename} - No Status field

---

Step 4: Summary

═══════════════════════════════════════════════════════════
SUMMARY: {passed} passed, {failed} failed, {warnings} warning(s), {skipped} skipped
═══════════════════════════════════════════════════════════

問題がある場合：

ISSUES TO FIX:
1. {issue description}
   {fix command}
2. ...

---

Example Output

═══════════════════════════════════════════════════════════
ALBUM VALIDATION: sample-album
═══════════════════════════════════════════════════════════

CONFIG
──────
[PASS] Config file exists
[PASS] content_root: ~/bitwize-music
[PASS] audio_root: ~/bitwize-music/audio
[PASS] artist: bitwize

ALBUM STRUCTURE
───────────────
[PASS] Album directory: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/
[PASS] README.md exists
[PASS] tracks/ directory exists
[PASS] 5 track files found

AUDIO FILES
───────────
[FAIL] Audio directory in wrong location
       → Expected: ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/
       → Found at: ~/bitwize-music/audio/sample-album/
       → Fix: mv ~/bitwize-music/audio/sample-album/ ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/

ALBUM ART
─────────
[SKIP] No album art yet

TRACKS
──────
[PASS] 01-intro.md - Status: Final, Suno Link: present
[PASS] 02-track.md - Status: Final, Suno Link: present
[WARN] 03-t-day-beach.md - Status: Generated, Suno Link: missing

═══════════════════════════════════════════════════════════
SUMMARY: 8 passed, 1 failed, 1 warning, 1 skipped
═══════════════════════════════════════════════════════════

ISSUES TO FIX:
1. Move audio folder to include artist:
   mv ~/bitwize-music/audio/sample-album/ ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/

---

Important Notes

1. まず MCP ツールを使用してください - 手動で確認する前に get_config()、find_album()、validate_album_structure() を実行します
2. 正しい場所と誤った場所の両方を確認してください - 配置場所の誤りを検出します
3. 実行可能な修正方法を提示してください - 問題を修正する正確なコマンドを含めます
4. 適切なステータスを使用してください - 重大度に応じて PASS/FAIL/WARN/SKIP を使い分けます
5. すべてを数えてください - サマリーに合計を報告します