New project from a brief

Write what you want made, and let Mastery HQ do the setup. One command creates the project folder, opens a window for each agent the brief names, gives them the rules they need, sends them the brief, and opens the Files window where the results appear.

The command

In the command bar, either of these:

• new project from C:\Users\you\Desktop\brief.md opens a brief you saved as a file.
• start a project: Lumen. Goal: a private cycle tracker. Deliverables: overview.md and app/index.html. takes the brief inline.

What a brief looks like

# Purrfect Time launch

Agents: Writer, Builder (codex)

Goal: launch materials for a smartwatch for cats.

Deliverables:
- Writer: positioning.md, a one-page positioning statement.
- Writer: a hero image: [[image hero as hero.png: a sleek matte-black cat collar watch]]
- Builder: app/index.html, a landing page that shows images/hero.png.
- A launch reel: [[reel as launch-reel.mp4: a cat wearing the watch at dawn | Purrfect Time | voiceover: Know where your cat is, always.]]

• The first heading (or first line) is the project’s name and its folder.
• Agents: is optional. Without it, one window named after the project does all the work.
• Brand: is optional too: Brand: Purrfect Time; colours #0A0C10 #FF5C1A #FFB27A; tone playful, warm becomes the project’s own Brand Kit (name, then background, primary and accent colours, then tone). Every image, clip and reel in the project is styled and titled with it instead of the global brand in Settings → Brand.
• Everything else is the brief. Address a line to an agent by name when the work should be split; otherwise every agent reads the whole brief.

What HQ adds

You never write the rules; HQ appends them to every copy of the brief:

• save everything in the project folder, and never create a nested one,
• name generated media with as so pages reference it correctly,
• plain prose without em dashes,
• finish with a manifest, one line per file made.

An existing window with the same name as an agent in the brief is reused and re-scoped to the project, so a second brief for the same team lands in a new folder without opening duplicate windows.