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; the project shape comes next.

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; its .ts source is the source of truth and out/ is the build artifact roblox-typescript-developer owns.

Read before editing

• Search services, modules, Remote names, Attribute names, and CollectionService tags with rg.
• Map the call direction of ServerScripts, LocalScripts, and ModuleScripts.
• Instance paths, Remote names, and UI control names come from the project.

Keep the server/client layering