Skip to content

Conversation

@bokelley
Copy link
Contributor

Summary

Addresses confusion about the purpose of list_creative_formats and its relationship with get_products by restructuring documentation to lead with the fundamental format discovery workflow.

Changes Made

  • Restructured Creative Lifecycle page to start with format discovery (Phase 1) before diving into library management details
  • Added format_ids parameter to list_creative_formats to support efficient reverse workflow
  • Documented both discovery approaches:
    • Inventory-first: "What products match my campaign?" → get format specs
    • Creative-first: "What video formats are supported?" → find matching inventory
  • Moved workflow discussion from individual tool docs to the Creative Lifecycle overview page
  • Added cross-references between tool docs and lifecycle page for better navigation

Problem Solved

The original question "what's the point of list_creative_formats?" now has a clear answer in the Creative Lifecycle page - it's the essential step that converts meaningless format ID strings from products into actual creative requirements you can build assets for.

Test Results

  • ✅ All schema validation tests pass
  • ✅ All example validation tests pass
  • ✅ TypeScript checks pass
  • ✅ Documentation build successful

🤖 Generated with Claude Code

bokelley and others added 2 commits September 14, 2025 11:09
Addresses confusion about the purpose of list_creative_formats and its relationship with get_products.

Key changes:
- Restructure Creative Lifecycle to lead with format discovery workflow
- Add format_ids parameter to list_creative_formats for reverse workflow support
- Document both inventory-first and creative-first discovery approaches
- Move workflow discussion from tool docs to Creative Lifecycle page
- Clarify synergistic relationship between get_products and list_creative_formats

The Creative Lifecycle now properly explains the fundamental question: "How do I figure out what creative formats I need to create?" before diving into library management details.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Combined changes from main branch (response time info) with format discovery workflow improvements.

Resolved conflicts in:
- docs/media-buy/tasks/get_products.md: Combined response time and enhanced format discovery text

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@bokelley bokelley merged commit de101b6 into main Sep 14, 2025
8 checks passed
@bokelley bokelley deleted the faq-why-formats branch September 14, 2025 09:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants