Skip to main content
A motion is a natural-language proposal for action. This page covers the full motion lifecycle from the UI side — creation, editing, publishing, collaboration, and closing. For the concept itself — what a motion is and how it moves through the three phases — see How Monnet works.

​
Create a motion

From any workspace, click New motion. You’ll see a form with a single text input asking what you want to propose. Type a short prompt — one or two sentences describing the decision. Examples:
Try something like
Should we buy team-wide Figma licenses at $25/seat/month?
Let’s define our core product workflows for MONNET.md.
We need a plan for the Q3 marketing launch.
Monnet drafts a structured motion from your prompt: a summary (one-liner), a body (the full markdown document), and a plan (execution steps). You land on the motion detail page, where you can edit everything before publishing.

​
Edit a draft

While a motion is in Draft state, you can edit three things inline on the motion page:
  • Summary — the one-liner that appears in feeds and the inbox.
  • Body — the full proposal as markdown. Click into the body to edit. This is where context, rationale, and resolution live.
  • Priority — Critical / Normal / Low. Use the Priority dropdown in the right panel.
Every edit while the motion is Open creates a new version automatically (see Versions).

​
Publish a motion

When the body is ready, click Publish in the action banner. The motion moves from Draft to Open:
  • All motion members see the motion.
  • Monnet activates the plan and starts coordinating with assignees.
  • Notifications go out to people assigned to the first set of plan steps.
Before you publish, the motion is only visible to you and any editors you’ve added.

​
Add motion members

Open the Members area on the motion page and click Add member. You can:
  • Add a workspace member — pick from your team list.
  • Invite someone by email — they’ll receive a link to join the motion (as an External member if they’re not in the workspace).
Pick a role for each: Editor, Commenter, or External. See the roles table.

​
Work through the plan

The plan is a list of execution steps, visible in the Progress card on the right of the motion page. Each step has:
  • A description.
  • A status (Pending / In progress / Done).
  • Assignees — the humans or agents responsible.
  • Optionally, an approval requirement — the step needs explicit approval from assignees before it’s marked done.
If a step requires approval and you’re an assignee, you’ll see a banner on the motion: “This motion needs your review.” Click Approve to mark the step done from your side, or Reject to send it back. When all required assignees approve, the step completes and the plan advances.

​
Comment on a motion

Any editor or commenter can post comments in the public discussion at the bottom of the motion page. Comments are visible to all motion members (including External members if any). Use them to propose changes, flag concerns, or document decisions that shouldn’t live in the body.

​
Chat privately with Monnet

Workspace members (not External members) can open the Private chat drawer from the bottom-right of the motion page. This is a private conversation with Monnet about the motion — ask for research, request changes, or spawn sub-motions without exposing the back-and-forth to all members.
If the motion has been published, the private chat can’t directly edit the body — it can only propose follow-ups. Edit the body inline on the motion page instead.

​
Attach files

Use the Files section in the right panel to upload supporting documents (contracts, mockups, spreadsheets, screenshots). Files are scoped to the motion and visible to all motion members. Click the X next to a file to remove it.

​
View and restore previous versions

Every edit while the motion is Open creates a version. Open the Activity timeline on the right panel and click a version to see the diff against the current body. Click Restore to roll back to that version — this creates a new version rather than deleting history.

​
Change priority

In the right panel, use the Priority dropdown to switch between Critical, Normal, and Low at any time. The change is broadcast to all members and shown as a colored dot on the motion.

​
Close or reopen a motion

When the work is finished (or the motion is no longer worth pursuing), an editor can Close it. Closed motions are read-only. Any editor can Reopen a closed motion later — it moves back to Open and the plan resumes where it left off.