2 definitions in this file:
Describes the scenario. Should be concrete and situation-driven — describe the user's situation, not the artifact's features.
Whether the use case is an example to follow or to avoid.
The recommended alternative artifact for this scenario. Typically provided for whenNotToUse entries to direct the reader toward a more appropriate component, pattern, or token.
References:
richText
Identifies this guideline as a purpose spec.
Scenario-driven guidance describing when this artifact is or is not the right choice.
Agent-optimized context for this document block. Provides structured information for AI/LLM consumption — constraints, disambiguation, anti-patterns, examples, and keywords.
References:
useCase, agents
Design System Documentation Standard (DSDS) 0.1 — Draft Specification
GitHub