# Isis Sky Atmosphere Pack Operator/Creator Documentation with Troubleshooting Runbook

Last Updated: 2026-03-02  
Scope: `MXA-0414` operator and creator documentation with troubleshooting
coverage for `sky-atmosphere-pack` workflows.

## Purpose

Generate and validate the canonical artifact that publishes creator and operator
guidance for `sky-atmosphere-pack`, including workflow usage instructions,
policy/error-code diagnostics, and troubleshooting playbooks for guardrail,
quality, regression, and downstream integration failures.

## Artifacts

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

## Generator

```bash
node scripts/isis/generate-v2-sky-atmosphere-pack-operator-creator-documentation-troubleshooting.mjs
```

Options:

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

## Validator

```bash
node scripts/isis/validate-v2-sky-atmosphere-pack-operator-creator-documentation-troubleshooting.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_SDK_END_TO_END_EXAMPLES.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_SIDE_BY_SIDE_COMPARISON_TOOLS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_COST_ESTIMATION_BUDGET_GUARDRAILS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_QUALITY_EVALUATOR_ACCEPTANCE_GATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_REGRESSION_TESTS_GOLDEN_DATASETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_EXTERNAL_INTEGRATION_RECIPE.json`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.tsx`
- `apps/isis/web/src/pages/sky-atmosphere-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/output-consistency-utils.ts`
- `apps/isis/web/src/pages/JobsPage.tsx`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `apps/isis/generation-api/src/routes/sky-atmosphere-pack-budget-utils.ts`
- `apps/isis/generation-api/src/routes/sky-atmosphere-pack-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/sky-atmosphere-pack-regression-golden-dataset.ts`
- `libs/isis/client/src/examples/external-integrations.ts`
- `libs/isis/client/src/examples/sky-atmosphere-pack.ts`

## Operational Cadence

1. Regenerate whenever creator controls, operator policy thresholds, regression
   drift scenarios, or downstream integration trigger contracts change.
2. Validate before closeout of downstream asset-family tasks that rely on
   creator/operator onboarding and troubleshooting readiness.
3. Keep troubleshooting signals aligned to canonical API error codes and
   workflow runbook diagnostics panels.

## Related Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_SIDE_BY_SIDE_COMPARISON_TOOLS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_COST_ESTIMATION_BUDGET_GUARDRAILS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_QUALITY_EVALUATOR_ACCEPTANCE_GATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_REGRESSION_TESTS_GOLDEN_DATASETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_EXTERNAL_INTEGRATION_RECIPE.json`
