Media Curator Framework

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

First time using AIWG? Begin with Install, Connect, and Verify. This guide assumes

AIWG is connected to the target project and your provider session can read the deployed context.

You're building a media archive — music, film, video, or any other collection. You want complete coverage of an artist or catalog, consistent metadata, proper file organization, and the ability to export to whatever platform you're using (Plex, Jellyfin, Navidrome, etc.).

The media curator framework handles catalog research, source discovery, acquisition planning, quality review, tagging, completeness checks, and export preparation. Use it to make collection decisions traceable before moving or renaming files.

Before You Start

Complete Install, Connect, and Verify first. If you intentionally run a targeted deployment instead of the complete system, the agent-owned use operation remains the manual command for this framework.

The first useful result should be a catalog reference, source plan, completeness report, or export plan you can review before changing the collection.

The curation workflow

analyze → discover sources → acquire → assess quality → tag → check completeness → export

Researching a catalog

Start by understanding what a complete collection looks like:

/analyze-artist "Radiohead"

The `discography-analyst` agent researches the artist's complete discography — studio albums, EPs, singles, live releases, compilations — identifies creative eras, and recommends how to structure the catalog. You get a canonical reference before you start acquiring anything.

Discovering sources

/find-sources "Radiohead" the scope option "complete"

The `source-discoverer` agent searches configured sources for available content. It ranks candidates by the evidence available for quality, legitimacy, and completeness so you can review a source list before acquiring anything.

Filter by format or quality threshold:

/find-sources "Radiohead - OK Computer" the min-quality option "lossless"

Acquiring content

/acquire the plan option sources.yaml

The `acquisition-manager` orchestrates parallel downloads with format selection, tracks progress, records errors for review, and logs the download plan for reproducibility.

Acquire a specific item:

/acquire "https://archive.org/details/..." the format option flac

Quality assessment

Every acquired file gets scored across audio quality, completeness, and uniqueness dimensions:

/quality-assess /path/to/collection the threshold option 0.85

Files below the threshold are flagged for replacement. The `quality-assessor` agent compares against other copies in your collection and against source metadata to detect encoding artifacts, clipping, and truncation.

Metadata and tagging

/tag-collection /path/to/collection

The `metadata-curator` agent applies consistent metadata tags, embeds artwork, enforces your naming conventions, and organizes files into the directory structure you specify. Works from MusicBrainz and your discography analysis — not guesses.

Enforce a specific naming convention:

/tag-collection /path/to/collection the convention option "artist/year - album/track - title"

Checking completeness

/check-completeness "Radiohead"

Compares your collection against the canonical discography to identify gaps. Shows what you have, what's missing, and what's available to acquire. The `completeness-tracker` prioritizes gaps by significance — studio albums before obscure B-sides.

Verifying integrity

/verify-archive /path/to/collection

SHA-256 integrity verification across the entire collection. Detects corruption, identifies files that have changed unexpectedly, and reports anything that doesn't match acquisition records.

Exporting to a platform

/export the profile option plex /path/to/collection /path/to/output
/export the profile option jellyfin /path/to/collection /path/to/output
/export the profile option navidrome /path/to/collection /path/to/output

Each export profile applies the metadata structure and directory organization that the target platform expects. The `asset-manager` handles the transformation without touching your source collection.

Full orchestration

Run the entire pipeline from scratch:

/curate "Radiohead" the output option /path/to/collection the quality option lossless

This runs analyze → discover → acquire → assess → tag → verify in sequence, pausing for confirmation at key decision points. Success is a reviewed collection plan plus verification records for the files AIWG actually handled.

Key references

`/check-completeness` — Collection gap analysis
`/verify-archive` — Integrity verification
`@agentic/code/frameworks/media-curator/README.md` — Full framework documentation