Your first workroom

A workroom is the unit of work. Get the naming and inputs right and the rest of AtelyaOS gets out of your way.

The 30-second version

A workroom is one bounded piece of work for one outcome — a proposal, a weekly report, a pitch outline. Name it for the client and the deliverable, paste real source material, and let the system agents (Planner, Composer) run. You don't need to invite the client.

Why this matters

The instinct from project-management tools is to create one project per client and pile everything in. AtelyaOS works better when each workroom is one deliverable end-to-end. That keeps the planner's task graph focused, makes revisions cheaper to compute, and gives you a clean export trail per piece.

You can have many workrooms for the same client — a proposal in March, a weekly report each Monday, an onboarding kit when they sign — and pick a different agent (and Style Memory) for each.

How it works

Create the workroom

From Workrooms → New, choose one of the entry points:

• Paste a brief — best for one-off proposals and recaps. Drop in the client email, notes, and a sample.
• From a template — recurring deliverables like weekly content calendars or onboarding kits.
• Blank — start from a goal statement only.

[SCREENSHOT: new workroom chooser screen]

Naming convention (recommended)

There is no enforced naming pattern, but the workspace is much easier to navigate if you adopt one. A pattern that works:

{ClientName} — {Deliverable} — {Period}

Concrete examples:

• Aurora Coffee — Q4 Proposal — 2026-05
• Northwind Real Estate — Weekly Report — 2026-W21
• Aurora Coffee — Brand Voice Onboarding Kit

If you leave the title blank, AtelyaOS uses the first 80 characters of the goal as the title.

Set the goal and deliverables

The workroom needs a goal (one paragraph, what you're trying to deliver) and one or more deliverables (short labels like "Q4 marketing proposal", "3 reel concepts"). Both are free text — there's no fixed taxonomy.

Pick the agents

By default each workroom uses two system agents:

• Planner — reads the goal and inputs, writes a task plan.
• Composer — produces the final deliverable from the executed tasks.

You can also add a custom agent trained for a specific client (see custom agents). The Composer will use that agent's Style Memory if it's the only non-system agent in the room.

Don't invite the client yet

External-client invites for workrooms are not yet available. During this phase, treat the workroom as an internal staging area: you draft and revise inside AtelyaOS, then export and share the deliverable through your existing channel (email, Slack, Drive). Coming soon: shareable read-only workroom links.

Common pitfalls

• One workroom for the whole engagement. Split one workroom per deliverable. Reusing one workroom across an entire quarter makes the planner's context unmanageable.
• Vague goal. "Help with Aurora Coffee" produces a vague plan. "Write a 4-page Q4 proposal for Aurora Coffee covering Instagram and YouTube Shorts, deadline 30 May" produces a tight one.
• No source material. Workrooms with no pasted inputs and no samples lean heavily on the LLM's defaults. Paste at least the source brief and one past deliverable.
• Renaming after the fact. You can rename a workroom, but exported filenames are slugified from the title at export time. Settle on the title before your first export.

What's next

• Workrooms — lifecycle and states.
• Paste a brief — the fastest way to start.
• Custom agents per client — give each client its own voice.