> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.forboc.ai/studio/overview/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.forboc.ai/_mcp/server.

# Arcane AI Studio

# Arcane AI Studio

`Stúdio_Init // Wórkbench_Óverview`

**ᚠ ᛫ ᛟ ᛫ ᚱ ᛫ ᛒ ᛫ ᛟ ᛫ ᚲ**

**[studio.forboc.ai](https://studio.forboc.ai)** is the web-based workbench for designing, testing, and exporting ForbocAI npcs — without writing a single line of code.

Build npc personas, run them through the multi-round protocol in a live playground, inspect their memory, and trace every decision they make.

---

## The Workbench

Wórkbench\_Módules // Thrée\_Pánels

The Studio is a three-panel workbench:

| Panel          | Purpose                                                                           |
| -------------- | --------------------------------------------------------------------------------- |
| **Sidebar**    | Navigate between modules: NPC Architect, Lore Weaver (Brain Scan), and Trace Logs |
| **Editor**     | Configure your npc's identity, persona, and action set                            |
| **Playground** | Chat with your npc in real time using the multi-round protocol                    |

---

## NPC Architect

Agént\_Scúlpt // Sóul\_Mánifest

Design your npc's identity with a visual editor. All changes are saved instantly.

| Field               | Description                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------ |
| **Entity Name**     | The npc's name (e.g., *Malakor the Wise*)                                                  |
| **Archetype**       | Behavioral class — Scholar, Rogue, Paladin, Necromancer                                    |
| **Prime Directive** | The system prompt that defines the npc's fundamental nature                                |
| **Action Grimoire** | Available actions the npc can take — `scout_area`, `cast_spell`, `query_lore`, or your own |

Click **Forge New Action** to add custom actions to the grimoire.

> **Info**
>
> **Tip**: The Prime Directive becomes the `persona` argument when you integrate the npc into your game via `createNPC()`.

---

## Chat Playground

Néural\_Intérrog // Prótocol\_Éxec

Test your npc in real time. The Playground runs the full **multi-round protocol** against the ForbocAI API:

```
You type a message
  → Process loop (primary atomic protocol route)
  → API instruction to recall memories (when needed)
  → API instruction to run local inference
  → Finalize verdict/memory/state instruction
  → Response appears in the chat
```

Every message goes through the same protocol your game will use. What you see in the Playground is what your players will experience.

#### Live Protocol

Real API calls — process loop and/or compatibility phase routes — not a mock

#### Instant Iteration

Edit the persona, test immediately, refine until it's perfect

---

## Brain Scan (Memory Inspector)

Mémory\_Scán // Véctor\_Mánifold

Inspect your npc's long-term memory. The Brain Scan shows:

* **Memory vectors** — What the npc remembers across sessions
* **Importance scores** — How strongly each memory influences decisions
* **Memory types** — Observations, lore, experiences, emotions
* **Temporal context** — When each memory was formed

This is powered by the same vector database (Orama) that runs in your game via `@forbocai/browser`.

---

## Trace Logs

Tráce\_Módule // Prótocol\_Mónitor

See exactly *why* your npc made each decision. The Trace Logs display the raw protocol round-trip:

| Step          | What You See                                           |
| ------------- | ------------------------------------------------------ |
| **DIRECTIVE** | The observation sent and memories recalled             |
| **CONTEXT**   | The full prompt constructed by the API                 |
| **VERDICT**   | Validation result, selected action, and soul signature |

Use this to debug npc behavior, tune persona prompts, and understand the decision-making process.

---

## Recommended Workflow

1. **Design** — Create a persona in the NPC Architect
2. **Test** — Chat with it in the Playground
3. **Inspect** — Check Brain Scan and Trace Logs to understand behavior
4. **Refine** — Adjust the Prime Directive and action set
5. **Integrate** — Use the same persona string in your game's `createNPC()` call

```typescript
// Your Studio-tested persona, now in your game
const npc = await createNPC({
  cortex,
  persona: 'Provide deep insights and historical context with a touch of arcane mystery.',
});

const response = await npc.process('What lies beyond the silver gate?');
```

---

᛭ ᛫ ᛬ ᛫ ᛭

> *D̵e̶s̴i̵g̷n̷ ̶t̸h̶e̵ ̸s̴o̵u̶l̸.̴ ̵T̸e̶s̵t̸ ̵t̷h̸e̵ ̵m̷i̵n̶d̵.̷ ̷D̶e̶p̸l̵o̷y̵ ̵t̴h̷e̸ ̶e̸n̷t̷i̸t̸y̵.*

> Design, test, and export autonomous npcs