Eve library

ISIS v2 Architecture Kitbash Pack Operator/Creator Documentation with Troubleshooting

Guide

Revision 1

On this page

Generated: 2026-02-28T16:34:26.009Z Checklist: MXA-0198 (ISIS2-00396) Asset Family: architecture-kitbash-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Publish creator and operator documentation with troubleshooting for architecture-kitbash-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=55, validationRules=30
operator Guardrails, regression, integration and runbook diagnostics envKeys=15, troubleshooting=6

Workflow Coverage#

Workflow Creator UI Documentation Operator Policy Documentation Troubleshooting Coverage
architecture-kitbash-pack-baseline yes yes yes
architecture-kitbash-pack-image-conditioned yes yes yes
architecture-kitbash-pack-control-conditioned yes yes yes
architecture-kitbash-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 ARCHITECTURE_KITBASH_PACK_BUDGET_GUARDRAIL_LIMIT_EXCEEDED operator yes
quality-gate-failed ARCHITECTURE_KITBASH_PACK_QUALITY_GATE_FAILED operator yes
regression-consistency-drift regression-architecture-kitbash-pack-consistency-drift operator yes
regression-output-package-contract-miss regression-architecture-kitbash-pack-package-contract-miss operator yes
downstream-trigger-integration-drift workflow-trigger-endpoint-mismatch operator yes

Creator Quickstart#

  • Select the architecture-kitbash-pack workflow variant that matches the shot intent and control profile.
  • Complete required kitbash parameters (theme, epoch, region, structure scale, module family, assembly grid profile, facade material profile, atlas layout, texel density class, lighting reference, and seed) plus any conditional controls before submit.
  • Use side-by-side output comparison to verify seam continuity, assembly-grid coherence, and lighting consistency before approval.
  • Export to downstream engine or DCC targets using recipe metadata for asset-family traceability.

Operator Diagnostics Surface#

  • X-Architecture-Kitbash-Pack-Estimated-Cost-Usd
  • X-Architecture-Kitbash-Pack-Budget-Guardrail-Mode
  • X-Architecture-Kitbash-Pack-Budget-Guardrail-Reason
  • X-Architecture-Kitbash-Pack-Quality-Gate-Mode
  • X-Architecture-Kitbash-Pack-Quality-Gate-Reason
  • X-Architecture-Kitbash-Pack-Quality-Failing-Metrics

Verification Commands#

  • pnpm --filter @isis/web exec vitest run src/pages/architecture-kitbash-pack-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx
  • pnpm --filter @isis/generation-api exec vitest run src/routes/architecture-kitbash-pack-budget-utils.spec.ts src/routes/architecture-kitbash-pack-quality-gate-utils.spec.ts src/routes/architecture-kitbash-pack-regression-golden-dataset.spec.ts
  • pnpm --filter @isis/client exec vitest run src/examples/external-integrations.spec.ts src/examples/architecture-kitbash-pack.spec.ts

Acceptance Criteria#

  • Creator documentation covers all architecture-kitbash-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-0198
  • Ticket key: ISIS2-00396
  • Linked checklist dependencies: MXA-0187, MXA-0188, MXA-0189, MXA-0194, MXA-0195, MXA-0196, MXA-0197