Skip to content

Relation

A relation is a typed, directed statement that one card makes about another item, such as “this card depends-on that one”. It lives at relations/<uuid>/index.md inside the card that makes the statement, and it is stored once, on that card only. The body of the file is an optional rationale in Markdown.

---
schema: 1
kind: relation
created: {at: 2026-11-09T10:00:00Z, by: {name: kim, kind: human}}
modified: {at: 2026-11-09T10:00:00Z, by: {name: kim, kind: human}}
rel: depends-on
to: lanework://0f3c2a9e-1b7d-4c55-9a40-6d2e8b1f7a13/9b47e2d1-3c80-4f6a-8e15-2a7d0c9b5e64
---
The export format cannot change until the schema card is done.
KeyTypeDescription
schema integer Always 1. Required.
kind text Always relation. Required.
created stamp A stamp: when the relation was stated and by whom.
modified stamp A stamp: the last write to the relation, including a change to suspect.
rel text Required. The type of the relation as free text, such as traces-to, depends-on or supersedes. The app gives it no meaning and shows it as written.
to lanework:// link Required. The target as a lanework:// link: usually a card, but it can be a board, lane, comment or attachment. It is resolved exactly as written, so write the full link.
suspect suspect flag Marks the relation as needing a re-check because something it depends on changed. Agents set and remove it; the app only displays it.

A relation has no title and no order. Nothing is stored on the target: its side of the link is worked out by reading the boards, so never write a matching relation back on the target.

rel is the type of the relation, in free text: traces-to, depends-on, supersedes. Lanework gives it no meaning and the board declares no list of types. It is shown as written. Reuse the words the board already uses so that relations stay easy to scan.

to is the target, written as a lanework:// link. It is usually a card, but it can also be a board, a lane, a comment or an attachment.

Write the full link. A short link, with each segment cut to the first eight or more hex digits, is legal and resolves by prefix, but the full form is safer. The link is resolved exactly as written, with no fallback search. A target Lanework cannot find is shown as unresolved and the value is left unchanged. If the target moved, write the new link yourself.

suspect says the relation needs re-checking because something it depends on has changed. Agents set and remove it. The app only displays it.

suspect:
since: 2026-11-10T09:00:00Z
by: {name: sam, kind: human}
cause: lanework://0f3c2a9e-1b7d-4c55-9a40-6d2e8b1f7a13/9b47e2d1-3c80-4f6a-8e15-2a7d0c9b5e64/4e8a1f37-b26c-4d09-a5e3-c71f9d2b0e86
KeyTypeDescription
since timestamp When the flag was set, as a timestamp.
by identity Who set the flag, as an identity mapping.
cause lanework:// link The comment that caused the flag, as a full lanework:// link, usually a change comment on another card.

Delete a relation by moving its folder into relations/.trash/, the same way a comment goes into comments/.trash/. Do not rewrite a relation into a different statement: delete it and write the new one.