Roblox Luau Developer

Workflow for implementing, reviewing, and refactoring Roblox Luau code, diagnosing runtime issues, and syncing Rojo-managed codebases. Assumes Luau and the Roblox server/client model; does not assume a project uses Rojo or TypeScript.

Identify the project shape

First determine how the project is organized:

• Rojo project: a default.project.json or *.project.json; the toolchain files and sync workflow live in references/rojo-workflow.md.
• Studio export: recognize .rbxlx, .rbxmx, .model.json, src/, ReplicatedStorage/, ServerScriptService/.
• TypeScript source: a roblox-ts project carries tsconfig.json, rbxtsc, and @rbxts/* packages; treat its .ts source as the source of truth and do not patch generated Luau under out/.

Read before editing

• Search services, modules, Remote names, Attribute names, and CollectionService tags with rg.
• Map the call direction of ServerScripts, LocalScripts, and ModuleScripts.
• Do not invent Instance paths, Remote names, or UI control names.

Keep the server/client layering