Start in the product UI. The repository includes workspace Home, Library and Resources; project Overview, Issues, Planning and Build; and operational Runs, Fleet and Settings surfaces. The generated API remains the contract for automation and integration, not the default explanation of a user’s task.
| Task | Start here |
|---|---|
| Commission and accept one result | Commission and follow an Outcome |
| Open a workspace and project | Source quickstart |
| Create and follow an Issue | Create and follow an Issue |
| Check why work cannot advance | Open the Issue detail diagnosis and scheduling sections |
| Inspect evidence or recover work | Use the Issue worklog, attention actions, and run controls |
| Author and bind a workflow | Design a workflow |
| Define an Agent | Define an Agent |
| Configure Agent execution and credentials | Define an Agent and Credential custody |
| Model and distribute domain definitions | Develop a Domain Pack |
| Publish, import, and adopt a Pack | Publish and install a Domain Pack |
| Monitor and steer work | Monitor WorkUnits |
| Decide permissions | Inbox and approvals |
| Recover non-progress | Attention and recovery |
| Plan a batch | Use Cycles |
For advanced diagnosis, inspect the Issue scheduling projection, WorkUnits and event stream, then the frozen execution snapshot and Resource joins. Act through the same approval, attention, or WorkUnit commands used by the UI; never edit persistence directly.
The current onboarding boundary is explicit: use awaken-flow project bootstrap
for the first Project. It calls the same authoritative Bootstrap API used by
integrations and does not seed persistence. Attention is resolved through the
Issue and control APIs described in the operating guides.