aiox-core 5.0.1 → 5.0.3

package/pro/squads/design/workflows/dtcg-tokens-governance.yaml

@@ -0,0 +1,64 @@
+# DTCG Tokens Governance Workflow
+# Standardize token extraction and mode modeling in W3C DTCG format.
+
+workflow:
+  id: "design-system-dtcg-tokens-governance"
+  name: "DTCG Tokens Governance"
+  description: "Extract, normalize, and validate design tokens using W3C DTCG-compatible structures."
+  version: "1.0.0"
+  type: "sequential"
+
+metadata:
+  author: "Brad (Design System Architect)"
+  created_date: "2026-02-17"
+  last_modified: "2026-02-17"
+  tags:
+    - design-system
+    - dtcg
+    - tokens
+    - governance
+
+inputs:
+  codebase_path:
+    type: "string"
+    description: "Path of token sources or UI artifacts"
+    required: true
+
+  project_name:
+    type: "string"
+    description: "Project namespace for outputs"
+    required: true
+    default: "my-app"
+
+steps:
+  - id: "step_1_extract_w3c_tokens"
+    name: "Extract W3C DTCG Tokens"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*token-w3c"
+    inputs:
+      path: "{{codebase_path}}"
+    outputs:
+      dtcg_tokens: "outputs/design-system/{{project_name}}/tokens/dtcg.tokens.json"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_2_model_token_modes"
+    name: "Model Token Modes"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*token-modes"
+    inputs:
+      tokens_file: "{{step_1_extract_w3c_tokens.dtcg_tokens}}"
+    outputs:
+      token_modes: "outputs/design-system/{{project_name}}/tokens/modes.tokens.json"
+    error_handling:
+      strategy: "fail"
+
+outputs:
+  dtcg_complete:
+    type: "boolean"
+    source: "step_2_model_token_modes.success"
+  tokens_file:
+    type: "string"
+    source: "step_1_extract_w3c_tokens.dtcg_tokens"

package/pro/squads/design/workflows/foundations-pipeline.yaml

@@ -0,0 +1,192 @@
+# Foundations Pipeline Workflow
+# 3-phase sequential pipeline: Tokens → Base Components → Derived Components
+
+workflow:
+  id: "foundations-pipeline"
+  name: "Design System Foundations Pipeline"
+  description: >
+    Pipeline sequencial para adaptar shadcn/UI default para o design system do produto.
+    Figma e a fonte de verdade. Cada fase tem QA gate bloqueante.
+  version: "1.0.0"
+  type: "sequential"
+
+metadata:
+  author: "Foundations Lead"
+  created_date: "2026-02-21"
+  last_modified: "2026-02-21"
+  tags:
+    - design-system
+    - foundations
+    - tokens
+    - shadcn
+    - figma
+
+inputs:
+  figma_tokens:
+    type: "string"
+    description: "Raw token input from Figma (CSS, JSON, or manual text)"
+    required: true
+
+  figma_components:
+    type: "string"
+    description: "Component specs from Figma Dev Mode (CSS + screenshots)"
+    required: false
+
+steps:
+  # =========================================================================
+  # PHASE 1: Foundations & Tokens
+  # =========================================================================
+  - id: "step_1_ingest_tokens"
+    name: "Ingest Figma Tokens"
+    phase: 1
+    type: "agent"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f1-ingest-figma-tokens.md"
+    inputs:
+      raw_input: "{{figma_tokens}}"
+    outputs:
+      normalized_tokens: "squads/design/data/tokens-normalized.json"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_2_map_tokens"
+    name: "Map Tokens to shadcn CSS Variables"
+    phase: 1
+    type: "agent"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f1-map-tokens-to-shadcn.md"
+    inputs:
+      normalized_tokens: "{{step_1_ingest_tokens.normalized_tokens}}"
+    outputs:
+      token_mapping: "squads/design/data/token-mapping-reference.md"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_3_apply_foundations"
+    name: "Apply Foundations to globals.css"
+    phase: 1
+    type: "agent"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f1-apply-foundations.md"
+    inputs:
+      token_mapping: "{{step_2_map_tokens.token_mapping}}"
+    outputs:
+      globals_css: "app/app/globals.css"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_4_qa_foundations"
+    name: "QA Gate — Foundations"
+    phase: 1
+    type: "gate"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f1-qa-foundations.md"
+    blocking: true
+    checklist: "squads/design/checklists/token-mapping-checklist.md"
+    verdicts:
+      PASS: "Proceed to Phase 2"
+      FAIL: "Return to step_3 with fixes"
+    error_handling:
+      strategy: "fail"
+
+  # =========================================================================
+  # PHASE 2: Base Components
+  # =========================================================================
+  - id: "step_5_ingest_components"
+    name: "Ingest Base Component Specs from Figma"
+    phase: 2
+    type: "agent"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f2-ingest-base-components.md"
+    inputs:
+      figma_specs: "{{figma_components}}"
+    outputs:
+      component_specs: "squads/design/data/component-specs.json"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_6_adapt_components"
+    name: "Adapt shadcn Base Components"
+    phase: 2
+    type: "agent"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f2-adapt-shadcn-components.md"
+    inputs:
+      component_specs: "{{step_5_ingest_components.component_specs}}"
+      token_mapping: "{{step_2_map_tokens.token_mapping}}"
+    outputs:
+      adapted_components: "components/ui/"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_7_qa_base_components"
+    name: "QA Gate — Base Components"
+    phase: 2
+    type: "gate"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f2-qa-base-components.md"
+    blocking: true
+    checklist: "squads/design/checklists/component-adaptation-checklist.md"
+    verdicts:
+      PASS: "Proceed to Phase 3"
+      FAIL: "Return to step_6 with fixes"
+    error_handling:
+      strategy: "fail"
+
+  # =========================================================================
+  # PHASE 3: Derived Components
+  # =========================================================================
+  - id: "step_8_derive_components"
+    name: "Derive Remaining Components"
+    phase: 3
+    type: "agent"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f3-derive-components.md"
+    inputs:
+      adapted_components: "{{step_6_adapt_components.adapted_components}}"
+      token_mapping: "{{step_2_map_tokens.token_mapping}}"
+    outputs:
+      all_components: "components/ui/"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_9_qa_final"
+    name: "QA Gate — Final (All Components)"
+    phase: 3
+    type: "gate"
+    agent: "ds-foundations-lead"
+    task: "squads/design/tasks/f3-qa-derived-components.md"
+    blocking: true
+    checklist: "squads/design/checklists/component-adaptation-checklist.md"
+    verdicts:
+      PASS: "Pipeline complete"
+      FAIL: "Return to step_8 with fixes"
+    error_handling:
+      strategy: "fail"
+
+outputs:
+  pipeline_complete:
+    type: "boolean"
+    description: "All 3 phases passed QA gates"
+    source: "step_9_qa_final.success"
+
+  token_mapping:
+    type: "string"
+    description: "Token mapping reference document"
+    source: "step_2_map_tokens.token_mapping"
+
+  modified_files:
+    type: "array"
+    description: "All files modified during the pipeline"
+    source: "aggregated"
+
+global_error_handling:
+  on_error: "abort"
+  notification:
+    enabled: true
+    channels:
+      - console
+
+security:
+  authorization_required: false
+  audit_logging: true

package/pro/squads/design/workflows/greenfield-new.yaml

@@ -0,0 +1,192 @@
+# Greenfield New Workflow
+# Start fresh with token-based design system (20% of use cases)
+
+workflow:
+  id: "design-system-greenfield-new"
+  name: "Design System Greenfield New"
+  description: "Greenfield workflow: start fresh with token-based design system, build production components from scratch. Mandatory governance protocol: squads/design/protocols/ai-first-governance.md"
+  version: "2.0.0"
+  type: "sequential"
+
+metadata:
+  author: "Brad (Design System Architect)"
+  created_date: "2025-10-27"
+  last_modified: "2026-02-16"
+  tags:
+    - design-system
+    - greenfield
+    - components
+    - brad
+
+inputs:
+  project_name:
+    type: "string"
+    description: "Project name for output organization"
+    required: true
+    default: "my-app"
+
+  tokens_source:
+    type: "string"
+    description: "Path to existing tokens.yaml (optional - will generate starter tokens if not provided)"
+    required: false
+
+  framework:
+    type: "string"
+    description: "Component framework (react, vue, svelte)"
+    required: true
+    default: "react"
+    validation: "Must be: react, vue, or svelte"
+
+steps:
+  - id: "step_1_setup"
+    name: "Initialize Design System Structure"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*setup"
+    inputs:
+      project_name: "{{project_name}}"
+      tokens_source: "{{tokens_source}}"
+      framework: "{{framework}}"
+    outputs:
+      tokens_yaml: "outputs/design-system/{{project_name}}/tokens/tokens.yaml"
+      structure_created: "outputs/design-system/{{project_name}}/"
+      state_file: "outputs/design-system/{{project_name}}/.state.yaml"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_2_build_atoms"
+    name: "Build Atomic Components"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*build"
+    inputs:
+      tokens: "{{step_1_setup.tokens_yaml}}"
+      patterns: "button,input,label,icon,badge,avatar,spinner"
+    outputs:
+      atoms: "outputs/design-system/{{project_name}}/components/atoms/"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_3_compose_molecules"
+    name: "Compose Molecule Components"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*compose"
+    inputs:
+      atoms: "{{step_2_build_atoms.atoms}}"
+      patterns: "form-field,card,alert,breadcrumb,pagination"
+    outputs:
+      molecules: "outputs/design-system/{{project_name}}/components/molecules/"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_4_compose_organisms"
+    name: "Compose Organism Components (Optional)"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*compose"
+    inputs:
+      atoms: "{{step_2_build_atoms.atoms}}"
+      molecules: "{{step_3_compose_molecules.molecules}}"
+      patterns: "form,table,modal,navigation"
+    outputs:
+      organisms: "outputs/design-system/{{project_name}}/components/organisms/"
+    error_handling:
+      strategy: "skip"
+
+  - id: "step_5_document"
+    name: "Generate Pattern Library Documentation"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*document"
+    inputs:
+      components: "outputs/design-system/{{project_name}}/components/"
+      tokens: "{{step_1_setup.tokens_yaml}}"
+    outputs:
+      documentation: "outputs/design-system/{{project_name}}/docs/"
+      storybook: "outputs/design-system/{{project_name}}/.storybook/"
+      readme: "outputs/design-system/{{project_name}}/README.md"
+    error_handling:
+      strategy: "skip"
+
+  - id: "step_6_promote_to_workspace"
+    name: "Promote Outputs to Workspace Canonical Locations"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*sync-registry"
+    description: "Move outputs from outputs/ to workspace canonical paths"
+    inputs:
+      tokens_source: "{{step_1_setup.tokens_yaml}}"
+      components_source: "outputs/design-system/{{project_name}}/components/"
+    outputs:
+      tokens_promoted: "workspace/system/tokens/"
+      registry_updated: "workspace/ui/registry.json"
+      metadata_updated: "workspace/domains/design-system/metadata/components.json"
+    promotion_map:
+      - from: "outputs/design-system/{{project_name}}/tokens/tokens.json"
+        to: "workspace/system/tokens/primitive.tokens.json"
+      - from: "outputs/design-system/{{project_name}}/tokens/tokens.yaml"
+        to: "squads/design/data/design-tokens-spec.yaml"
+      - from: "outputs/design-system/{{project_name}}/components/"
+        to: "workspace/ui/components/"
+    validation:
+      - "workspace/ui/registry.json updated with new components"
+      - "workspace/domains/design-system/metadata/components.json reflects changes"
+      - "squads/design/scripts/design-system/validate_components_metadata.cjs passes"
+    error_handling:
+      strategy: "fail"
+
+outputs:
+  design_system_complete:
+    type: "boolean"
+    description: "Workflow completed successfully"
+    source: "step_6_promote_to_workspace.success"
+
+  tokens_location:
+    type: "string"
+    description: "Path to design tokens"
+    source: "step_1_setup.tokens_yaml"
+
+  components_location:
+    type: "string"
+    description: "Path to generated components"
+    source: "outputs/design-system/{{project_name}}/components/"
+
+  documentation_location:
+    type: "string"
+    description: "Path to pattern library documentation"
+    source: "step_5_document.documentation"
+
+  storybook_location:
+    type: "string"
+    description: "Path to Storybook configuration"
+    source: "step_5_document.storybook"
+
+global_error_handling:
+  on_error: "abort"
+  notification:
+    enabled: true
+    channels:
+      - console
+
+security:
+  authorization_required: false
+  audit_logging: true
+
+quality_gates:
+  internal_quality_chain:
+    required:
+      - "node squads/design/scripts/design-system/generate_components_metadata.cjs"
+      - "node squads/design/scripts/design-system/validate_components_metadata.cjs"
+      - "node squads/design/scripts/design-system/sync_design_manifest.cjs"
+      - "node squads/design/scripts/design-system/validate_design_manifest_drift.cjs"
+      - "node squads/design/scripts/design-system/validate_task_checklist_bindings.cjs"
+      - "node squads/design/scripts/design-system/validate_mcp_skeleton.cjs"
+    optional:
+      - "node squads/design/scripts/design-system/test_mcp_tools.cjs"
+    blocking: true
+    policy: "internal-first"
+    exception:
+      external_tool_allowed_with:
+        - "capability_gap_documented"
+        - "rationale_recorded"

package/pro/squads/design/workflows/motion-quality.yaml

@@ -0,0 +1,65 @@
+# Motion Quality Workflow
+# Audit and improve animation and motion tokens with accessibility constraints.
+
+workflow:
+  id: "design-system-motion-quality"
+  name: "Design System Motion Quality"
+  description: "Run motion audit, then establish motion token quality baseline for safer animations."
+  version: "1.0.0"
+  type: "sequential"
+
+metadata:
+  author: "Brad (Design System Architect)"
+  created_date: "2026-02-17"
+  last_modified: "2026-02-17"
+  tags:
+    - design-system
+    - motion
+    - accessibility
+    - quality
+
+inputs:
+  codebase_path:
+    type: "string"
+    description: "Path to components/styles for motion analysis"
+    required: true
+
+  project_name:
+    type: "string"
+    description: "Project namespace for outputs"
+    required: true
+    default: "my-app"
+
+steps:
+  - id: "step_1_motion_audit"
+    name: "Audit Motion Patterns"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*motion-audit"
+    inputs:
+      path: "{{codebase_path}}"
+    outputs:
+      motion_report: "outputs/design-system/{{project_name}}/motion/motion-audit.md"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_2_visual_regression_guard"
+    name: "Validate Visual Regression Baseline"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*visual-regression"
+    inputs:
+      path: "{{codebase_path}}"
+      motion_report: "{{step_1_motion_audit.motion_report}}"
+    outputs:
+      visual_report: "outputs/design-system/{{project_name}}/motion/visual-regression.md"
+    error_handling:
+      strategy: "skip"
+
+outputs:
+  motion_quality_complete:
+    type: "boolean"
+    source: "step_1_motion_audit.success"
+  motion_report:
+    type: "string"
+    source: "step_1_motion_audit.motion_report"