# ISIS Marketing Key Art Pack External Integration Recipe Runbook

Last Updated: 2026-03-03  
Scope: `MXA-0503` external integration recipe coverage for
`marketing-key-art-pack` workflows and downstream tools/systems.

## Purpose

Generate and validate the canonical artifact that captures typed downstream
integration recipes for `marketing-key-art-pack` workflows, including target
coverage, trigger contracts, and webhook-aligned metadata governance.

## Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_MARKETING_KEY_ART_PACK_EXTERNAL_INTEGRATION_RECIPE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MARKETING_KEY_ART_PACK_EXTERNAL_INTEGRATION_RECIPE.md`

## Generator

```bash
node scripts/isis/generate-v2-marketing-key-art-pack-external-integration-recipe.mjs
```

Options:

- `--report-date=YYYY-MM-DD` (default: current UTC date)

## Validator

```bash
node scripts/isis/validate-v2-marketing-key-art-pack-external-integration-recipe.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MARKETING_KEY_ART_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_EXTERNAL_INTEGRATION_COOKBOOK.json`
- `libs/isis/client/src/examples/external-integrations.ts`
- `libs/isis/client/src/examples/external-integrations.spec.ts`
- `libs/isis/client/src/index.ts`
- `apps/isis/generation-api/src/routes/workflows.ts`

## Operational Cadence

1. Regenerate when downstream target lists, workflow trigger contracts, or
   webhook callback requirements change.
2. Validate before release-candidate sign-off for `marketing-key-art-pack`
   integrations with engines and DCC toolchains.
3. Keep recipe metadata (`assetFamilyId`, `recipeId`) aligned with downstream
   ingestion and observability requirements.

## Related Artifacts

- `libs/isis/client/src/examples/external-integrations.ts`
- `libs/isis/client/src/examples/external-integrations.spec.ts`
- `docs/domains/isis/remediation-v2/ISIS_V2_EXTERNAL_INTEGRATION_COOKBOOK.json`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
