Velt Suggestions Best Practices

Comprehensive guide for implementing Velt's Suggestions API — a propose-then-review editing workflow where edits (from humans or AI agents) are captured as proposals that reviewers accept or reject. Contains 14 rules across 6 categories.

When to Apply

Reference these guidelines when:

• Adding suggestion mode to form inputs, tables, or custom components
• Implementing an AI-proposes / human-reviews workflow
• Wiring data-velt-suggestion-target attributes to DOM elements
• Handling accept/reject events and applying accepted changes
• Querying suggestions by target or status for custom UI
• Understanding suggestion lifecycle states (pending → accepted/rejected/stale)

Rule Categories by Priority