Documenting Design Systems - Architecture Decisions Record with Claude Desktop скачать в хорошем качестве

Documenting Design Systems - Architecture Decisions Record with Claude Desktop

Ever stared at your own design system wondering "why did I do this?" 😅 Design tokens tell you WHAT the decision is, but not WHY. Architecture Decision Records fix that - and Claude Desktop makes keeping them updated almost effortless. In this quick tip video, I'll show you: ✨ What an Architecture Decision Record (ADR) is and why your design system needs one ✨ How to manually update your ADR using Obsidian (it's free!) ✨ My preferred workflow using Claude Desktop with MCP servers connected to Airtable ✨ A live demo of Claude helping me document a naming decision I'd forgotten the reasoning behind (spoiler: quaternary is a "smell" 🤭) Whether you're a design team of one or collaborating with others, this simple template will save future-you from reverse-engineering your own decisions. ⏱️ TIMESTAMPS: 0:00 What is an Architecture Decision Record? 0:38 Manual workflow in Obsidian 1:02 Setting up Claude Desktop for ADRs 1:52 Demo: Asking Claude to review the ADR 2:48 Example: Why we avoid hierarchy names (primary, secondary, quaternary...) 5:56 Claude asks a clarifying question 6:18 Claude creates the updated ADR 7:12 Adding the new version to your project 7:46 Using ADRs to inform future decisions 9:07 Wrap up 🔗 RESOURCES & LINKS: Get the Template: 📄 Download the ADR Template: https://github.com/samiamdesigns/futu... Read More: 📝 Full article on ADRs: https://samiamdesigns.substack.com/p/... Connect with Sam: 🫶 Find me everywhere: https://bento.me/samiam (Workshops, socials, and more) Tools I'm using: ✍️ Obsidian: https://obsidian.md/ 🤖 Claude Desktop by @anthropic-ai : https://www.claude.com/download Topics and Tags #DesignSystems #DesignTokens #DesignDocumentation #AI #FutureFriendlyDesign #AIDesign #ClaudeDesktop