56 lines
1.4 KiB
Markdown
56 lines
1.4 KiB
Markdown
|
# Users & workflows
|
||
|
|
|
||
|
|
<!--
|
||
|
|
Every actor that touches the system. Humans AND non-humans:
|
||
|
|
- other humans (collaborators, viewers, admins)
|
||
|
|
- AI agents
|
||
|
|
- integrations / webhooks
|
||
|
|
- scheduled jobs
|
||
|
|
- the data / export format itself
|
||
|
|
- future-self
|
||
|
|
- backups
|
||
|
|
Workflows extracted by asking "what do you do?" and then "who or what
|
||
|
|
is on the other side of each verb?"
|
||
|
|
-->
|
||
|
|
|
||
|
|
## Primary user
|
||
|
|
|
||
|
|
**<Name or role>**
|
||
|
|
- **Context**: <what they're doing when they reach for this app>
|
||
|
|
- **Job to be done**: <what success looks like for them>
|
||
|
|
- **Frequency**: <daily / weekly / occasional>
|
||
|
|
|
||
|
|
## Other user-classes
|
||
|
|
|
||
|
|
<!--
|
||
|
|
List every other actor surfaced by the workflow probe. One block each.
|
||
|
|
Non-human classes (agents, integrations, format) get the same treatment
|
||
|
|
as humans.
|
||
|
|
-->
|
||
|
|
|
||
|
|
### <user-class name>
|
||
|
|
- **Type**: <human / agent / integration / system / format>
|
||
|
|
- **Reads**: <what they read>
|
||
|
|
- **Writes**: <what they write, if anything>
|
||
|
|
- **Notes**: <anything special about their access pattern or constraints>
|
||
|
|
|
||
|
|
## Anti-personas
|
||
|
|
|
||
|
|
<!--
|
||
|
|
Who this app is NOT for. Naming these saves stories later, because
|
||
|
|
"can't we also support X?" gets a clean answer.
|
||
|
|
-->
|
||
|
|
|
||
|
|
- <type of user/use case explicitly excluded>
|
||
|
|
- <another>
|
||
|
|
|
||
|
|
## Workflows
|
||
|
|
|
||
|
|
<!--
|
||
|
|
Verb-keyed list. Each workflow is short. Detailed step-by-step lives
|
||
|
|
in flows.md.
|
||
|
|
-->
|
||
|
|
|
||
|
|
- **<verb>** — <one-line description, who's on each side>
|
||
|
|
- **<verb>** — …
|