# Isis Foliage Pack Operator/Creator Documentation with Troubleshooting Runbook

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

## Purpose

Generate and validate the canonical artifact that publishes creator and operator
guidance for `foliage-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_FOLIAGE_PACK_OPERATOR_CREATOR_DOCUMENTATION_TROUBLESHOOTING.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_OPERATOR_CREATOR_DOCUMENTATION_TROUBLESHOOTING.md`

## Generator

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

Options:

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

## Validator

```bash
node scripts/isis/validate-v2-foliage-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_FOLIAGE_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_SDK_END_TO_END_EXAMPLES.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_WEB_UI_CONTROLS_VALIDATION.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_COST_ESTIMATION_BUDGET_GUARDRAILS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_QUALITY_EVALUATOR_ACCEPTANCE_GATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_REGRESSION_TESTS_GOLDEN_DATASETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_EXTERNAL_INTEGRATION_RECIPE.json`
- `apps/isis/web/src/pages/WorkflowDetailsPage.tsx`
- `apps/isis/web/src/pages/foliage-pack-ui-utils.ts`
- `apps/isis/web/src/pages/JobsPage.tsx`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `apps/isis/generation-api/src/routes/foliage-pack-budget-utils.ts`
- `apps/isis/generation-api/src/routes/foliage-pack-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/foliage-pack-regression-golden-dataset.ts`
- `libs/isis/client/src/examples/external-integrations.ts`
- `libs/isis/client/src/examples/foliage-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_FOLIAGE_PACK_WEB_UI_CONTROLS_VALIDATION.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_COST_ESTIMATION_BUDGET_GUARDRAILS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_QUALITY_EVALUATOR_ACCEPTANCE_GATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_REGRESSION_TESTS_GOLDEN_DATASETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_EXTERNAL_INTEGRATION_RECIPE.json`
