Skip to content
AssureSwarm Docs

Agent Operating Guide

/coach-items-link

Link two items, or unlink them, as one suggestion for a human to approve.

Create a relationship between two items, relate, connect, or associate them, or, with --unlink, break an existing link. The skill resolves each side (by id or by a title search), picks the relationship kind, and submits one suggestion for a human to approve; nothing is linked or unlinked until you approve it in Canvas.

When to use

Section titled “When to use”

When you want to relate one item to another, link an audit to a risk, attach an issue to a control, or detach a link you no longer want. It creates or removes one link per call.

Inputs

Section titled “Inputs”
Flag Required Notes
--source-id <id> or --source-title <text> [--source-type <slug>] Yes The source item: by id, or by a title search optionally narrowed to a type.
--target-id <id> or --target-title <text> [--target-type <slug>] Yes The target item, resolved the same way.
--kind <related|parent|child|sibling> No Defaults to related. With --unlink, picks which link to remove when the pair has more than one.
--unlink No Remove the relationship instead of creating it.
--reason <text> No The suggestion’s reason field.

Example

Section titled “Example”

/coach-items-link --source-title "Vendor risk" --source-type risk --target-title "Access control" --target-type control --kind child submits a suggestion linking the risk under the control: kind is read from the source’s perspective, so the risk is the child. You review and approve it in Canvas.

Good to know

Section titled “Good to know”
  • Direction is from the source’s perspective. kind: "parent" means the source is the parent of the target; child is the inverse. “Link this risk under this control” makes the risk the source and child the kind.
  • Unlink is human-reviewed too. The delete suggestion mirrors the create shape and lands in the same approval queue; the item’s history (including the past link) stays, only the current link goes.
  • Re-linking the same pair with the same kind is rejected as a duplicate: the skill surfaces the error and asks whether to remove the existing link first.
  • Item-to-item only. Linking a step to an item, or a document to a step, are different flows.
Section titled “Related”