Eve library
ISIS v2 NPC Crowd Variation Pack Operator/Creator Documentation with Troubleshooting
Guide
Revision 1
On this page
Generated: 2026-08-02T17:39:32.120Z Checklist: MXA-0108 (ISIS2-00306) Asset
Family: npc-crowd-variation-pack Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)
Objective#
Publish creator and operator documentation with troubleshooting for
npc-crowd-variation-pack workflows, spanning workflow authoring, guardrail
operations, regression diagnostics, and downstream integration remediation.
Persona Coverage#
| Persona |
Workflow Focus |
Coverage Signals |
creator |
Workflow authoring, variant controls, typed submission |
controls=52, validationRules=30 |
operator |
Guardrails, regression, integration and runbook diagnostics |
envKeys=15, troubleshooting=6 |
Workflow Coverage#
| Workflow |
Creator UI Documentation |
Operator Policy Documentation |
Troubleshooting Coverage |
npc-crowd-variation-pack-baseline |
yes |
yes |
yes |
npc-crowd-variation-pack-image-conditioned |
yes |
yes |
yes |
npc-crowd-variation-pack-control-conditioned |
yes |
yes |
yes |
npc-crowd-variation-pack-consistency-locked |
yes |
yes |
yes |
Troubleshooting Matrix#
| Issue |
Signal |
Persona |
Source Coverage |
creator-contract-validation-failure |
INVALID_WORKFLOW_RUN_REQUEST |
creator |
yes |
budget-hard-limit-exceeded |
NPC_CROWD_VARIATION_PACK_BUDGET_GUARDRAIL_LIMIT_EXCEEDED |
operator |
yes |
quality-gate-failed |
NPC_CROWD_VARIATION_PACK_QUALITY_GATE_FAILED |
operator |
yes |
regression-consistency-drift |
regression-npc-crowd-consistency-drift |
operator |
yes |
regression-output-package-contract-miss |
regression-npc-crowd-package-contract-miss |
operator |
yes |
downstream-trigger-integration-drift |
workflow-trigger-endpoint-mismatch |
operator |
yes |
Creator Quickstart#
- Select the npc-crowd-variation-pack workflow variant that matches the shot
intent and control profile.
- Complete required archetype/style/seed fields and any conditional control maps
before submit.
- Use side-by-side output comparison to verify identity/style consistency before
approval.
- Export to downstream engine or DCC targets using recipe metadata for
asset-family traceability.
Operator Diagnostics Surface#
X-Npc-Crowd-Variation-Pack-Estimated-Cost-Usd
X-Npc-Crowd-Variation-Pack-Budget-Guardrail-Mode
X-Npc-Crowd-Variation-Pack-Budget-Guardrail-Reason
X-Npc-Crowd-Variation-Pack-Quality-Gate-Mode
X-Npc-Crowd-Variation-Pack-Quality-Gate-Reason
X-Npc-Crowd-Variation-Pack-Quality-Failing-Metrics
Verification Commands#
pnpm --filter @isis/web exec vitest run src/pages/npc-crowd-variation-pack-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx
pnpm --filter @isis/generation-api exec vitest run src/routes/npc-crowd-variation-pack-budget-utils.spec.ts src/routes/npc-crowd-variation-pack-quality-gate-utils.spec.ts src/routes/npc-crowd-variation-pack-regression-golden-dataset.spec.ts
pnpm --filter @isis/client exec vitest run src/examples/external-integrations.spec.ts src/examples/npc-crowd-variation-pack.spec.ts
Acceptance Criteria#
- Creator documentation covers all npc-crowd-variation-pack workflow variants,
required controls, validation constraints, and typed SDK run paths.
- Operator documentation covers budget and quality guardrail policies, required
environment keys, regression diagnostics, and monitoring headers.
- Troubleshooting matrix includes creator-input, budget, quality, regression,
and downstream integration remediation flows with concrete source
traceability.
- Published documentation remains reproducible through generator/validator
scripts and evidence-linked governance artifacts.
Traceability#
- Checklist item:
MXA-0108
- Ticket key:
ISIS2-00306
- Linked checklist dependencies:
MXA-0099, MXA-0100, MXA-0101, MXA-0104,
MXA-0105, MXA-0106, MXA-0107