# Roblox Architecture

> Service hierarchy, 7 foundational patterns, cross-platform input. Client-server architecture, module patterns, framework options.

- **Type:** Skill
- **Install:** `agentstack add skill-tabooharmony-roblox-brain-roblox-architecture`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [TabooHarmony](https://agentstack.voostack.com/s/tabooharmony)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [TabooHarmony](https://github.com/TabooHarmony)
- **Source:** https://github.com/TabooHarmony/roblox-brain/tree/main/skills/roblox-architecture

## Install

```sh
agentstack add skill-tabooharmony-roblox-brain-roblox-architecture
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Roblox Game Architecture Reference

---

## 1. Overview

**Load this reference when:**

- Starting a new Roblox game from scratch and need to decide where code and assets go
- Organizing or refactoring an existing codebase that has grown unwieldy
- Answering architecture questions: "Where should this script go?", "How should client talk to server?", "How do I structure modules?"
- Onboarding onto a Roblox project and need to understand the standard conventions
- Choosing between a flat script layout and a modular loader pattern

This document covers the Roblox data model, service hierarchy, script types, client-server communication, module patterns, framework options, folder organization, best practices, and anti-patterns.

---

## Quick Reference

**Load Full Reference below only when you need specific folder layouts or framework comparisons.**

Key rules:
- ServerScriptService: server logic (never visible to client)
- ServerStorage: server-only assets/data
- ReplicatedStorage: shared modules, RemoteEvents, assets both sides need
- StarterPlayerScripts: client controllers (run once per player)
- StarterGui: ScreenGuis (cloned to PlayerGui on spawn)
- Script types: Script (server), LocalScript (client), ModuleScript (shared, returns one table)
- Communication: RemoteEvent (fire-and-forget), RemoteFunction (request-response, avoid for client→server)
- Module pattern: return a table of functions. One module = one responsibility.
- Avoid circular requires. Use events/signals for cross-module communication.
- Single entry point per side: one server Script requires service modules, one LocalScript requires controllers.
**Need more detail?** Load `references/full.md` for the complete reference with code examples, API tables, and edge cases.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [TabooHarmony](https://github.com/TabooHarmony)
- **Source:** [TabooHarmony/roblox-brain](https://github.com/TabooHarmony/roblox-brain)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tabooharmony-roblox-brain-roblox-architecture
- Seller: https://agentstack.voostack.com/s/tabooharmony
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.