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: 1kind: relationcreated: {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-onto: lanework://0f3c2a9e-1b7d-4c55-9a40-6d2e8b1f7a13/9b47e2d1-3c80-4f6a-8e15-2a7d0c9b5e64---
The export format cannot change until the schema card is done.| Key | Type | Description |
|---|---|---|
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
Section titled “Suspect”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| Key | Type | Description |
|---|---|---|
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. |
Deleting a relation
Section titled “Deleting a relation”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.