Version: 0.1.0

Domain Packs

Version: 0.1.0

Domain packs are DecisionBox's extensibility model. They define what the AI looks for and how it reasons about data for a specific industry. Without a domain pack, DecisionBox wouldn't know whether to look for churn patterns, cart abandonment rates, or supply chain bottlenecks.

Available Domain Packs

Domain	Categories	Base Areas	Description
Gaming	Match-3, Idle/Incremental, Casual/Hyper-Casual	Churn, Engagement, Monetization	Player behavior, retention, and revenue analytics for games
Social Network	Content Sharing	Growth, Engagement, Retention	User growth, engagement, content creation, and monetization analytics for social platforms

What's in a Domain Pack

A domain pack provides four things:

Component	What it does	File type
Categories	Sub-types within a domain	Go code
Analysis Areas	What patterns to find	JSON + Markdown
Prompts	How the AI reasons	Markdown files
Profile Schema	What context users provide	JSON Schema

Three-Level Hierarchy

Domain: Gaming
├── Category: Match-3
│   ├── Area: Churn Risks          (base — shared)
│   ├── Area: Engagement Patterns  (base — shared)
│   ├── Area: Monetization         (base — shared)
│   ├── Area: Level Difficulty     (match-3 specific)
│   └── Area: Booster Usage        (match-3 specific)
│
├── Category: Idle / Incremental
│   ├── Area: Churn Risks          (base — shared)
│   ├── Area: Engagement Patterns  (base — shared)
│   ├── Area: Monetization         (base — shared)
│   ├── Area: Progression & Prestige  (idle specific)
│   └── Area: Economy Balance         (idle specific)
│
└── Category: Casual / Hyper-Casual
    ├── Area: Churn Risks          (base — shared)
    ├── Area: Engagement Patterns  (base — shared)
    ├── Area: Monetization         (base — shared)
    ├── Area: Ad Performance       (casual specific)
    └── Area: Session Flow         (casual specific)

Domain: Social Network
└── Category: Content Sharing
    ├── Area: Growth & Activation     (base — shared)
    ├── Area: Engagement Patterns     (base — shared)
    ├── Area: Retention & Churn       (base — shared)
    ├── Area: Content Creation Health  (content sharing specific)
    └── Area: Monetization & Premium   (content sharing specific)

Base areas are shared across all categories in a domain. Category-specific areas add specialized analysis. When you select "Gaming / Match-3", you get all base gaming areas PLUS match-3 specific areas.

File Structure

Each domain pack follows the same structure:

domain-packs/gaming/
├── go/
│   ├── pack.go                    # Registers the pack, implements interfaces
│   ├── discovery.go               # Categories, analysis areas, prompts loading
│   └── *_test.go                  # Tests
│
├── prompts/
│   ├── base/                      # Shared across ALL gaming categories
│   │   ├── areas.json             # Base analysis area definitions
│   │   ├── base_context.md        # Shared context (profile, previous results)
│   │   ├── exploration.md         # Main exploration system prompt
│   │   ├── analysis_churn.md      # Churn pattern analysis prompt
│   │   ├── analysis_engagement.md # Engagement pattern analysis prompt
│   │   ├── analysis_monetization.md # Monetization analysis prompt
│   │   └── recommendations.md     # Recommendation generation prompt
│   │
│   └── categories/
│       ├── match3/                # Match-3 specific
│       │   ├── areas.json         # Additional areas (levels, boosters)
│       │   ├── exploration_context.md  # Appended to base exploration
│       │   ├── analysis_levels.md     # Level difficulty analysis
│       │   └── analysis_boosters.md   # Booster usage analysis
│       ├── idle/                  # Idle/Incremental specific
│       │   ├── areas.json         # Additional areas (progression, economy)
│       │   ├── exploration_context.md
│       │   ├── analysis_progression.md
│       │   └── analysis_economy.md
│       └── casual/                # Casual/Hyper-Casual specific
│           ├── areas.json         # Additional areas (ads, session flow)
│           ├── exploration_context.md
│           ├── analysis_ad_performance.md
│           └── analysis_session_flow.md
│
└── profiles/
    ├── schema.json                # Base gaming profile (JSON Schema)
    └── categories/
        ├── match3.json            # Match-3 extensions
        ├── idle.json              # Idle extensions
        └── casual.json            # Casual extensions

The social network domain pack follows the same structure under domain-packs/social/.

Areas Definition (areas.json)

Each areas.json defines which analysis areas are available and maps them to prompt files.

Example — Gaming base areas (prompts/base/areas.json):

[
  {
    "id": "churn",
    "name": "Churn Risks",
    "description": "Players at risk of leaving the game — identify churn patterns across the player lifecycle",
    "keywords": ["churn", "retention", "cohort", "day_", "d1_", "d7_", "d30_", "inactive", "lapsed"],
    "priority": 1,
    "prompt_file": "analysis_churn.md"
  }
]

Example — Social base areas (prompts/base/areas.json):

[
  {
    "id": "growth",
    "name": "Growth & Activation",
    "description": "User acquisition funnel, signup conversion, onboarding completion, and viral growth loops",
    "keywords": ["signup", "registration", "onboarding", "activation", "invite", "referral", "viral"],
    "priority": 1,
    "prompt_file": "analysis_growth.md"
  }
]

Field Reference

Field	Required	Description
`id`	Yes	Unique identifier (lowercase, no spaces). Used in API, prompts, insights.
`name`	Yes	Human-readable display name.
`description`	Yes	What this analysis area looks for. Shown in the dashboard.
`keywords`	Yes	Keywords to match exploration results with this area. The agent filters queries by these keywords when feeding data to the analysis prompt.
`priority`	Yes	Execution order (1 = first). Also controls display order in the UI.
`prompt_file`	Yes	Filename of the analysis prompt (relative to the areas.json directory).

How Prompts Are Merged

When the agent loads prompts for a project with domain=gaming, category=match3:

1. Load base exploration prompt:
   prompts/base/exploration.md

2. Append category context (if exists):
   + prompts/categories/match3/exploration_context.md

3. Load base context:
   prompts/base/base_context.md

4. Load analysis prompts:
   Base areas:
     churn     → prompts/base/analysis_churn.md
     engagement → prompts/base/analysis_engagement.md
     monetization → prompts/base/analysis_monetization.md
   Category areas:
     levels    → prompts/categories/match3/analysis_levels.md
     boosters  → prompts/categories/match3/analysis_boosters.md

5. Load recommendations prompt:
   prompts/base/recommendations.md

The same merging logic applies to all domain packs and categories.

Project-level overrides: Users can edit any prompt per-project via the dashboard's Prompts page. Overrides are stored in MongoDB and take priority over domain pack files.

Profile Schema

The profile schema defines what context users provide about their product. It's a JSON Schema that the dashboard renders as a dynamic form.

Gaming Profile

Base schema (profiles/schema.json) — Fields shared across all gaming categories:

Basic info (genre, platforms, target audience)
Gameplay (core mechanic, session type, difficulty curve)
Monetization (model, has ads, has IAP, primary revenue source)
Social features (guilds, leaderboards, PvP, chat)
Live ops (daily rewards, seasonal events, battle pass)
KPIs (retention targets, ARPU target, DAU target)

Category extensions add domain-specific fields:

Match-3 — Progression (levels, star system), boosters, IAP packages, lootboxes
Idle — Prestige system, currencies, generators, ad boosts
Casual — Core loop, onboarding, ad configuration, secondary features

Base schema — Fields shared across all social categories:

Platform info (type, content format, target audience, growth stage)
Engagement model (feed type, stories, messaging, groups, connection model)
Monetization (premium subscriptions, IAP features, virtual currency, creator monetization, paid messaging, paid content, ads)
Growth features (referral, contact sync, push notifications)
KPIs (DAU/MAU ratio, retention targets, creator ratio, premium conversion, ARPU)

Category extensions:

Content Sharing — Content types, discovery features, interaction types (with paid flags), creator tools, moderation

The schemas are merged at runtime (base + category). The resulting form lets users describe their specific product, which the AI uses as context for better analysis.

How Domain Packs Are Loaded

DOMAIN_PACK_PATH environment variable (default: /app/domain-packs)
  ↓
domain-packs/
  gaming/                    ← domain pack directory
    go/pack.go               ← registers via domainpack.Register("gaming", ...)
    prompts/                 ← read at runtime via DOMAIN_PACK_PATH
    profiles/                ← read at runtime via DOMAIN_PACK_PATH
  social/                    ← domain pack directory
    go/pack.go               ← registers via domainpack.Register("social", ...)
    prompts/                 ← read at runtime via DOMAIN_PACK_PATH
    profiles/                ← read at runtime via DOMAIN_PACK_PATH

The Go code reads prompt and profile files from the filesystem at runtime (not embedded at compile time). This means:

You can edit prompts without recompiling
Docker images bake prompts into /app/domain-packs/
In development, DOMAIN_PACK_PATH points to the repo's domain-packs/ directory

Creating Your Own

See the Creating Domain Packs guide for a step-by-step tutorial on building a domain pack for your industry.

Next Steps

Providers — Plugin architecture for LLM, warehouse, and secrets
Prompts — Template variables and prompt customization
Creating Domain Packs — Build your own

Available Domain Packs​

What's in a Domain Pack​

Three-Level Hierarchy​

File Structure​

Areas Definition (areas.json)​

Field Reference​

How Prompts Are Merged​

Profile Schema​

Gaming Profile​

Social Network Profile​

How Domain Packs Are Loaded​

Creating Your Own​

Next Steps​