Deliverables

A deliverable is what leaves AtelyaOS — a .docx or .pdf with your letterhead applied.

The 30-second version

Each workroom produces one deliverable per export. You can export to .docx or .pdf. The export uses your workspace export profile (company name, tagline, contact, accent colour) as the letterhead. Filenames follow the pattern {slugified-workroom-title}-v{round}.{format}. Re-exporting after a revision round increments the version suffix.

Why this matters

The thing you're paid for is the document you send to a client. AtelyaOS keeps that simple: write inside a workroom, export when it's right, and ship. There is no separate "publish" step, no Markdown handoff, and no need to re-paste output into Word to add your letterhead.

How it works

What a deliverable is

A deliverable is the rendered output of a workroom's composition task, exported to a file. It's not a separate database object you create — it's the result of calling the export endpoint on a completed workroom.

Supported formats

EXPORT_FORMATS = ["docx", "pdf"]

Both come out of the same source content. Pick .docx if the client is going to edit; pick .pdf if the deliverable is final.

[SCREENSHOT: export modal with .docx and .pdf options]

Filename convention

Files are named automatically:

{slugified-workroom-title}-v{round_number}.{format}

Examples:

• aurora-coffee-q4-proposal-v1.docx
• northwind-real-estate-weekly-report-v3.pdf

round_number is the current revision round when you export. So a workroom with two revision rounds, exported after each, produces …-v1.pdf, …-v2.pdf, …-v3.pdf. The slug comes from the workroom title at export time — set the title before your first export.

Letterhead and branding

Letterhead is text-based today and lives at Settings → Export profile for the workspace:

• Company name and optional tagline.
• Address, contact email, contact phone.
• Font choice and PDF accent colour.
• Optional "Prepared with AtelyaOS" footer line.

Image-based letterheads (uploaded logo, custom header band) are coming soon. The current export profile is text-only.

Deliverable types

There is no fixed taxonomy of deliverable types. The workroom's deliverables field is a free-text array — typical labels include:

• Proposal
• Weekly report
• Onboarding kit
• Pitch outline
• Scope change

The label is for your own organisation; AtelyaOS does not branch behaviour on it.

Costs

Exporting is free — it doesn't consume credits. Credits are spent at workroom-creation time (when the Planner and Composer run) and at each revision round. See credits explained.

Common pitfalls

• Renaming the workroom after export. The slug is captured at export time, so v1 may have a different slug than v2 if you renamed in between. Pick the title once and stick with it.
• Exporting a non-completed workroom. Exports are only available on completed workrooms. If the state is executing or composing, wait it out.
• Expecting Markdown export. AtelyaOS exports to .docx and .pdf only. No Markdown, no HTML, no Google Doc API push (yet).
• Skipping the export profile. Without a workspace export profile, the letterhead is generic. Set it up once under Settings → Export profile and every export inherits it.

What's next

• Letterhead and branding — set up the export profile.
• Export deliverable — the workflow walkthrough.
• Approval and revisions — what happens between drafts and exports.