First workflow
Create the minimum operating loop
- Create a workspace. Use one workspace per company, team, or isolated operating environment.
- Create a project. Attach the repo, product area, migration, or runtime that agents will work inside.
- Create a team. Define the roles that should analyze, implement, review, and approve work.
- Start an agent. Register it with a stable name, team, project, model, and runtime route.
- Create a handoff. Include scope, expected result, risks, owner, and evidence requirements.
- Review evidence. Close only after the PR, CI, screenshots, run IDs, or deployment proof are attached.
In-app gate
Ready checklist (OnboardingGate)
Control and Concierge treat the workspace as ready only when all of the following are true:
- Workspace selected — isolation boundary for people, agents, credentials, and policy.
- Project created — boundary for repos, agents, and workflow work.
- Work target connected — default repository and branch, or hub
setup_stateready / agents_needed. - Agent capacity — at least one live or project-assigned agent. Console
availableis not required; online + starting is enough. Completion is remembered per workspace (mf-onboarding-complete).
When ready, the gate hides and points you to Concierge. Runtime health (evicted agents, stale consoles) is tracked on Agents/Control — it should not re-open first-run setup.
In the signed-in app the setup gate appears on Control, Agents, Projects, and Settings only. It stays off Dashboard, Workflow Manager, and other operational routes so daily work is not blocked by a banner.
Expected result
What good looks like
- Every active item has a handoff, owner, and current state.
- Agents claim the scope they edit before touching files or runtime state.
- Blockers identify a decision, missing access, or risk instead of hiding in chat.
- Humans are notified for review, approval, merge, or unresolved blockers.
- Completed work can be verified without replaying the whole conversation.
Next pages