Skip to content
AssureSwarm Docs

Agent Operating Guide

/coach-glossary

Define a AssureSwarm-specific term in a sentence or two, platform vocabulary, the shared-core item types and fields, and audit or SOX jargon, with a citation and a translation for deprecated pre-refactor terms.

Look up what a AssureSwarm-specific term means. The skill defines the term in one to three sentences from the docs snapshot’s concepts directory, cites the canonical doc, and links the sibling skills relevant to it. Crucially, it also translates deprecated pre-refactor terms, vocabulary from before the shared-core model, to their current replacement, so an old word resolves cleanly instead of sending you on a hunt. It’s answers-only and never writes to your tenant.

When to use

Section titled “When to use”

When you hit a term you don’t recognize, slug, isCore, tsvector, suggest_change, FormAssignment, materiality, TOD/TOE, or an old term like control_test or audit_finding and want to know what it maps to now. For how a mechanism actually works, use /coach-ask; for the steps to do a task, use /coach-howto. Glossary is for a single term’s definition.

Example

Section titled “Example”

/coach-glossary remediation_task returns “Deprecated item type: now a workflow Step on the parent issue item,” with a source link and a couple of related terms. Live terms work the same way: /coach-glossary tsvector defines it as the PostgreSQL full-text search vector on the Item table, populated from the title plus any field marked isSearchable.

Good to know

Section titled “Good to know”
  • The deprecated-term table is load-bearing. remediation_task becomes a workflow Step on an issue, audit_finding becomes an issue linked to an audit, control_test becomes a Step on a control: operators who learned Canvas before the shared-core refactor get a clean translation, not a dead end.
  • For audit and SOX acronyms (SOC 2, ISO 27001, CC6.1), it returns both the expansion and a one-line “used by” pointer to the relevant shared-core item type or field.
  • If a term isn’t in its cache or the docs, it says so plainly rather than inventing a definition: a signal you may be reading non-canonical material.
Section titled “Related”