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