archflow-design

Selects a project design system and produces per-story screen designs that clear design gates.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-design-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-design
Source: https://github.com/AZidan/archflow/tree/main/adapters/copilot/.github/skills/archflow-design
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-design-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? UI work in an AI-assisted project drifts when every agent invents its own components and tokens. This Skill establishes one design system per project and produces per-story screen designs just-in-time, so frontend and backend work stay consistent and each story's design gate is cleared before its build. ## Core Features & Use Cases - Design system picker: Filters a catalogue of design systems by platform (Flutter, SwiftUI, React, Next.js, Vue, WinUI, and more), then writes the choice to .archflow/design-system.yaml with platform, library, and theme settings. - Custom brand tokens: Supports a custom-tokens option that imports an existing tokens.json, generates a starter token file from a brand color, or defers the decision to Phase 2. - Per-story design gate: Resolves a story id like S7-20, checks its needs_design gate and status, dispatches a ux-designer agent scoped to that story, and advances the story status only after human acceptance. - Use Case: A developer runs /archflow-design pick to choose Material 3 for a Flutter app, then later runs /archflow-design S7-20 to generate and approve the screens for that story before its build begins. ## Quick Start Ask the agent to run /archflow-design pick to choose a design system for the project, or run /archflow-design followed by a story id to design that story's screens.

Frequently Asked Questions about archflow-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose a design system for my project?

Run /archflow-design pick to filter the catalogue by your UI platform and confirm a choice. The selection is written to .archflow/design-system.yaml with the platform, library, and theme mode, and every UI agent reads it afterward.

How do I design screens for a single story?

Run /archflow-design followed by the story id, such as /archflow-design S7-20. The command checks the story's design gate, dispatches a ux-designer scoped to that story, and advances its status only after you accept the produced artifacts.

Which platforms does the design system picker support?

Supported platform ids include flutter, android_compose, ios_swiftui, ipados_swiftui, macos_swiftui, ios_uikit, macos_appkit, react_native, web_react, web_next, web_vue, web_components, and windows_winui. A system is only offered if its frontmatter lists the chosen platform.

Can I use my own brand design tokens?

Yes, choose the custom-tokens option during the picker. You can point to an existing tokens.json or Figma variables export, generate a starter tokens.json seeded from one brand color, or defer the decision to Phase 2.

What happens if I change the design system mid-project?

The command warns that existing screens and design artifacts keep the old system's component names and tokens until rebuilt. On confirmation it writes the new choice and appends the change, date, and reason to .archflow/history.yaml.

Why does the design command stop for a story in the backlog?

Design runs one step ahead of a story's build, not ahead of its scheduling. A backlog story must first be pulled into the active release with /archflow-feature before its screens can be designed.