Documentation / Use Glyph

Design workflow

From understanding the product to inspecting the result.

Understand and choose

Inspect the current UI and code. Establish the audience, primary task, real content, existing brand, language and technical constraints.

For open-ended work, compare a few meaningfully different compositions. Explain the tradeoffs and choose a direction. For an established product, preserve its direction unless redesign is requested.

Compose and express

Sketch or code the important screen with actual content. Decide hierarchy, proportions, density, typography and asset placement before polishing individual components.

Decide what carries the personality: real product imagery, illustration, photography, typography, interaction or a combination. Check asset provenance and rights.

Build and interact

Use the actual project stack. Implement responsive behavior and applicable loading, empty, error, success, focus and disabled states.

Add motion where it clarifies an action, relationship or state. Consider distance, frequency, interruption and reduced motion. There is no universal duration cap.

Verify and revise

Inspect rendered desktop and mobile screens. Exercise interactions and failure paths, compare with the chosen direction, revise and repeat.

Report the checks performed and what remains uncertain. Do not call an illustrative walkthrough a controlled model evaluation.
View the verification checklist

Guides & section titles

IntroductionWhat Glyph does and when to use it.What is Glyph?IntroductionHow to think about itIntroductionStart buildingIntroductionInstallationAdd Glyph to your coding assistant.Install with the skills CLIInstallationInstall from a local checkoutInstallationVerify the installationInstallationDesign workflowFrom understanding the product to inspecting the result.Understand and chooseDesign workflowCompose and expressDesign workflowBuild and interactDesign workflowVerify and reviseDesign workflowCommands & promptsWays to ask your assistant to use Glyph.Request conventionsCommands & promptsAn example briefCommands & promptsGuidance & exceptionsUnderstand requirements, patterns and design judgment.Instruction rolesGuidance & exceptionsWhen to break a patternGuidance & exceptionsResearch with referencesGuidance & exceptionsSkill filesRead the actual Markdown included in the skill.Explore the sourceSkill filesLoad guidance selectivelySkill filesCustomizationAdapt Glyph to your brand and project.Bring your own directionCustomizationWrite useful constraintsCustomizationTroubleshootingResolve installation, discovery and output issues.The assistant cannot find GlyphTroubleshootingThe result feels genericTroubleshootingCopy or theme is unavailableTroubleshootingVerificationCheck the implementation and report evidence honestly.Before shippingVerificationEvaluating the skillVerificationCurrent evidence limitsVerificationSources & licenseAttribution, license and reference use.Source acknowledgmentsSources & licenseMIT licenseSources & license
Tab to move · Enter to open · Esc to close