Glossary & data model

The canonical dictionary. Every other page — and every agent — uses exactly these terms.

ID prefixes

Prefix	Object	Example
org_	Organization	org_8f3a
usr_	Person / member	usr_ravi
snp_	Snippet	snp_7c4b2e09
brd_	Board	brd_q3roadmap
lst_	List (board column)	lst_inreview
crd_	Card	crd_PS117
tdo_	Todo	tdo_01JX4R8K
ms_	Milestone	ms_SP14
evt_	Audit event	evt_01JX4R8KQ2
chk_	Agent checklist in development	chk_01JX9M2P
ses_	Agent worklog session in development	ses_01hx4n7q

Cards and milestones also carry a human ref (PS-117, SP-14) used in branch names, chat, and CLI commands.

Entities

Organization

The isolation boundary. Every workspace object belongs to exactly one organization; every read and write is scoped to it at the service layer. People can belong to several organizations with different roles.

Member & roles

A person's membership in an organization. Roles: Owner (everything incl. billing), Admin (manage members, integrations, boards), Member (work), Viewer (read-only). API tokens and MCP connections carry the person's role.

Snippet

A versioned fragment of type html, sql, json, or txt. Visibility is private or team. Each snippet has at most one public link (https://qd.sk/s/<slug>): read-only, revocable, returns 404 after deletion or rotation. Saving never overwrites — it creates the next version.

Board, List, Card

A board is a set of lists (columns) cards move through. A card is the unit of team work: title, description, labels, due date, assignees, subtasks, linked PRs, comments. workflow_status is one of backlog · in_progress · in_review · done.

• Gated board — a board where the move into done requires a human caller.
• PR linking — a branch named feat/PS-117-… links its PR to card PS-117; merge events move the card.

Subtask ↔ Todo mirroring

A subtask assigned to a person is mirrored into that person's Todos, marked as card-linked. Completing either side completes both. Unassigned subtasks stay on the card only.

Todo ("Today")

A personal commitment: title, priority (urgent · high · medium · low), optional due date, optional org_id tag, optional card_id link. Todos belong to the person, not the organization; only the org tag is visible to teammates. The nav label is Today; the API object is todo.

Milestone

A sprint (kind: sprint, date range) or deadline (kind: deadline, single date) grouping cards across boards. Reports two independent counts: cards done/total and criteria done/total. The label "at the human gate" means cards sitting in in_review awaiting a human approver.

Inbox item (notification)

An item requiring acknowledgement, response, review, or action — mentions, assignments, review requests, due/overdue alerts. Pure event logs (card moved, member joined) appear in object activity feeds instead. Nav label Inbox; API object notification.

Audit event

An immutable record of a write: actor (person), door (ui · cli · mcp · http), agent attribution when applicable (via Claude), verb, object, timestamp. Every mutation produces one.

Terminology rules

• "public link" (not "share URL"), "door" (not "channel/surface"), "gated move" (not "locked transition"), "Today"/"Inbox" as nav labels with todo/notification as API objects.
• Status values are always the four workflow_status strings above — no synonyms.