# exploreomni/omni-artifact-accelerator architecture

> Architecture diagram of the GitHub repository exploreomni/omni-artifact-accelerator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/exploreomni/omni-artifact-accelerator
- Repository: https://github.com/exploreomni/omni-artifact-accelerator

## Overview

Omni Artifact Accelerator is a portable collection of AI-agent skills and local workflow helpers for designing, preparing, and reviewing native Omni dashboards and Apps, plus preparing Reports Beta and migrating existing BI artifacts. The principal workflow carries a business question through engagement setup, analysis and experience design, implementation preparation, and independent review; native publication remains separately authorized. Migration and backend handoff are conditional routes. The README documents the stages and capabilities, but most source modules were not inspected, so detailed internal call relationships are omitted.

Main entry points: [`skills/omni-artifact-accelerator/scripts/analyst_project.py`](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/analyst_project.py) (Engagement Orchestrator), [`skills/omni-artifact-translator/scripts/translate_artifact.py`](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-translator/scripts/translate_artifact.py) (Artifact Translation), [`skills/omni-backend-handoff/scripts/cowork.py`](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-backend-handoff/scripts/cowork.py) (Backend Handoff), [`harness/asset_checks.py`](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/harness/asset_checks.py) (Asset Validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engagement["Engagement Workflow"]
  node_analyst["Engagement Orchestrator<br/>[analyst_project.py]"]
  node_context["Scoped Context<br/>[context_packets.py]"]
  node_routing["Task Routing<br/>[task_routing.py]"]
  node_delivery["Delivery Workflow"]
end

subgraph group_design["Design And Review"]
  node_intent["Design Intent<br/>[design_intent.py]"]
  node_experience["Experience Design"]
  node_visual["Visual Workflow<br/>[visual_workflow.py]"]
  node_review["Independent Review<br/>[stage_gates.py]"]
end

subgraph group_migration["Migration And Handoff"]
  node_translator["Artifact Translation"]
  node_source_readers["BI Source Readers"]
  node_handoff["Backend Handoff<br/>[cowork.py]"]
  node_continuation["Standalone Continuation<br/>[standalone.py]"]
end

subgraph group_native["Native Authoring"]
  node_app_builder["App Engineering<br/>[omni_app_native.py]"]
  node_query_controller["Query Controller"]
  node_report_builder["Report Authoring<br/>[report_native.py]"]
  node_bi_native["Dashboard Authoring<br/>[omni_native.py]"]
end

subgraph group_spatial["Spatial Apps"]
  node_scene_authoring["3D Scene Authoring"]
  node_scene_viewer["3D Viewer<br/>[viewer.js]"]
  node_scene_validation["Asset Validation<br/>[asset_checks.py]"]
end

node_host(("Approved AI Host"))

node_host -->|"runs workflow"| node_analyst
node_analyst -->|"scopes evidence"| node_context
node_analyst -->|"assigns specialists"| node_routing
node_analyst -->|"frames requirements"| node_intent
node_analyst -->|"guides design"| node_experience
node_analyst -->|"coordinates concepts"| node_visual
node_analyst -->|"coordinates review"| node_review
node_analyst -->|"prepares delivery"| node_delivery
node_translator -.->|"reads source formats"| node_source_readers
node_analyst -.->|"routes migration"| node_translator
node_analyst -.->|"routes handoff"| node_handoff
node_handoff -.->|"continues baseline"| node_continuation
node_app_builder -.->|"uses query state"| node_query_controller
node_scene_authoring -.->|"validates assets"| node_scene_validation
node_scene_viewer -.->|"checks GLB profile"| node_scene_validation

click node_analyst "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/analyst_project.py"
click node_context "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/context_packets.py"
click node_routing "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/task_routing.py"
click node_intent "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/design_intent.py"
click node_experience "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/experience_contract.py"
click node_visual "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/visual_workflow.py"
click node_review "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/stage_gates.py"
click node_delivery "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/delivery_workflow.py"
click node_translator "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-translator/scripts/translate_artifact.py"
click node_source_readers "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-translator/scripts/migration_sources.py"
click node_handoff "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-backend-handoff/scripts/cowork.py"
click node_continuation "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-backend-handoff/scripts/standalone.py"
click node_app_builder "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-app-engineer/scripts/omni_app_native.py"
click node_query_controller "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-app-engineer/scripts/query_controller.js"
click node_report_builder "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-report-builder/scripts/report_native.py"
click node_bi_native "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-bi-engineer/scripts/omni_native.py"
click node_scene_authoring "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-app-engineer/scripts/native_authoring.py"
click node_scene_viewer "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/harness/viewer.js"
click node_scene_validation "https://github.com/exploreomni/omni-artifact-accelerator/blob/main/harness/asset_checks.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_analyst,node_context,node_routing,node_delivery toneBlue
class node_intent,node_experience,node_visual,node_review toneAmber
class node_translator,node_source_readers,node_handoff,node_continuation toneMint
class node_app_builder,node_query_controller,node_report_builder,node_bi_native toneRose
class node_scene_authoring,node_scene_viewer,node_scene_validation,node_host toneIndigo
```

## Components

### Engagement Workflow

- [Engagement Orchestrator](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/analyst_project.py): `skills/omni-artifact-accelerator/scripts/analyst_project.py`
- [Scoped Context](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/context_packets.py): `skills/omni-artifact-accelerator/scripts/context_packets.py`
- [Task Routing](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/task_routing.py): `skills/omni-artifact-accelerator/scripts/task_routing.py`
- [Delivery Workflow](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/delivery_workflow.py): `skills/omni-artifact-accelerator/scripts/delivery_workflow.py`

### Design And Review

- [Design Intent](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/design_intent.py): `skills/omni-artifact-accelerator/scripts/design_intent.py`
- [Experience Design](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/experience_contract.py): `skills/omni-artifact-accelerator/scripts/experience_contract.py`
- [Visual Workflow](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/visual_workflow.py): `skills/omni-artifact-accelerator/scripts/visual_workflow.py`
- [Independent Review](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-accelerator/scripts/stage_gates.py): `skills/omni-artifact-accelerator/scripts/stage_gates.py`

### Migration And Handoff

- [Artifact Translation](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-translator/scripts/translate_artifact.py): `skills/omni-artifact-translator/scripts/translate_artifact.py`
- [BI Source Readers](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-artifact-translator/scripts/migration_sources.py): `skills/omni-artifact-translator/scripts/migration_sources.py`
- [Backend Handoff](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-backend-handoff/scripts/cowork.py): `skills/omni-backend-handoff/scripts/cowork.py`
- [Standalone Continuation](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-backend-handoff/scripts/standalone.py): `skills/omni-backend-handoff/scripts/standalone.py`

### Native Authoring

- [App Engineering](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-app-engineer/scripts/omni_app_native.py): `skills/omni-app-engineer/scripts/omni_app_native.py`
- [Query Controller](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-app-engineer/scripts/query_controller.js): `skills/omni-app-engineer/scripts/query_controller.js`
- [Report Authoring](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-report-builder/scripts/report_native.py): `skills/omni-report-builder/scripts/report_native.py`
- [Dashboard Authoring](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-bi-engineer/scripts/omni_native.py): `skills/omni-bi-engineer/scripts/omni_native.py`

### Spatial Apps

- [3D Scene Authoring](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/skills/omni-app-engineer/scripts/native_authoring.py): `skills/omni-app-engineer/scripts/native_authoring.py`
- [3D Viewer](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/harness/viewer.js): `harness/viewer.js`
- [Asset Validation](https://github.com/exploreomni/omni-artifact-accelerator/blob/main/harness/asset_checks.py): `harness/asset_checks.py`

### Other components

- **Approved AI Host**

## Connections

- Approved AI Host → Engagement Orchestrator: runs workflow (evidence: `README.md`)
- Engagement Orchestrator → Scoped Context: scopes evidence (evidence: `README.md`)
- Engagement Orchestrator → Task Routing: assigns specialists (evidence: `README.md`)
- Engagement Orchestrator → Design Intent: frames requirements (evidence: `README.md`)
- Engagement Orchestrator → Experience Design: guides design (evidence: `README.md`)
- Engagement Orchestrator → Visual Workflow: coordinates concepts (evidence: `README.md`)
- Engagement Orchestrator → Independent Review: coordinates review (evidence: `README.md`)
- Engagement Orchestrator → Delivery Workflow: prepares delivery (evidence: `README.md`)
- Artifact Translation → BI Source Readers: reads source formats
- Engagement Orchestrator → Artifact Translation: routes migration (evidence: `README.md`)
- Engagement Orchestrator → Backend Handoff: routes handoff (evidence: `README.md`)
- Backend Handoff → Standalone Continuation: continues baseline (evidence: `skills/omni-backend-handoff/scripts/standalone.py`)
- App Engineering → Query Controller: uses query state
- 3D Scene Authoring → Asset Validation: validates assets
- 3D Viewer → Asset Validation: checks GLB profile
