validate-album

Album Validator Agent

Your Task

Input: $ARGUMENTS (album name, e.g., sample-album)

Validate that an album has all required files in the correct locations, catching path issues and missing content before they become problems.

Step 1: Load Config & Find Album

1. Call get_config() — returns paths (content_root, audio_root, documents_root) and artist.name

   • If config missing, STOP and report:

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

2. Call find_album(album_name) — fuzzy match by name, slug, or partial

   • If not found, STOP and report (MCP returns available albums):

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

3. Optionally call validate_album_structure(album_slug) — runs structural validation checks and returns {passed, failed, warnings, skipped, issues[], checks[]}. This MCP tool handles directory structure, required files, audio placement, and track content checks in one call.

Note: The MCP validate_album_structure tool performs many of the checks below automatically. You can use its results directly or run the manual checks for more detailed reporting.

Step 3: Run Validations

Initialize Counters

• passed = 0
• failed = 0
• warnings = 0
• skipped = 0
• issues = [] (list of fix commands)

Output Header

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

Validation Categories

CONFIG

CONFIG
──────