Skip to content

Conversation

@abbasmhd
Copy link

@abbasmhd abbasmhd commented Dec 24, 2025

Overview

Adds a new optional accessibility analysis step to the section design workflow, positioned after screen designs and before screenshots. This feature enables users to analyse their screen designs for WCAG compliance and generate actionable accessibility reports.

Changes

New Features

  • Accessibility Command (/add-accessibility): Analyses screen design components and generates WCAG-based accessibility reports
  • AccessibilityCard Component: Displays accessibility checklist with compliance status by WCAG level (A, AA, AAA)
  • Accessibility Data Loading: Parses and loads accessibility reports from product/sections/[section-id]/accessibility.md

UI Updates

  • Added accessibility as Step 4 in the section workflow (after screen designs, before screenshots)
  • Updated step status logic to track accessibility analysis completion
  • Added empty state for accessibility with command reference

Type System

  • Added AccessibilityInfo and AccessibilityChecklistItem interfaces
  • Extended SectionData to include accessibility information

Documentation

  • Updated workflow documentation to include accessibility step
  • Added accessibility command to quick reference tables
  • Updated file structure documentation to include accessibility.md

Workflow Integration

The accessibility step fits into the existing section design workflow:

  1. Shape the Section
  2. Create Sample Data
  3. Design the Screen
  4. Add Accessibility ← New step
  5. Capture Screenshots

Technical Details

  • Accessibility reports are stored as markdown files in product/sections/[section-id]/accessibility.md
  • Reports include WCAG compliance checklist organized by level (A, AA, AAA)
  • Checklist items support status tracking (pass, warning, fail, not-checked)
  • Full accessibility reports are displayed in collapsible sections with compliance summaries

Usage

Users can run /add-accessibility after creating screen designs to:

  • Analyse components for common accessibility issues
  • Generate WCAG compliance checklists
  • Receive screen-specific recommendations
  • Track accessibility improvements over time

The accessibility analysis is optional and does not block progression to other steps.

image

…hecklist generation. Updated documentation to include new command and accessibility section. Introduced AccessibilityCard component for displaying analysis results.
@abbasmhd abbasmhd marked this pull request as ready for review December 24, 2025 06:06
cabana8471-arch added a commit to cabana8471-arch/design-os that referenced this pull request Dec 26, 2025
RESPONSIVE DESIGN (buildermethods#12):
- AppLayout.tsx: Add responsive padding to main content (px-4 sm:px-6 py-8 sm:py-12)
- SectionPage.tsx: Make screenshots grid responsive (grid-cols-1 sm:grid-cols-2)
- DesignPage.tsx: Make color/typography grids responsive (grid-cols-1 sm:grid-cols-3)

BARREL FILES (buildermethods#13):
- Create src/components/index.ts with 32 exports (pages, cards, layout, navigation)
- Create src/components/ui/index.ts with 14 exports (all UI primitives)

Benefits:
- Mobile layouts now adapt properly with stacking grids
- Components can be imported from single entry points
- Better tree-shaking support for production builds

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
cabana8471-arch added a commit to cabana8471-arch/design-os that referenced this pull request Dec 29, 2025
…ons (6 fixes)

FIXES:
- export-product.md: Added Rule 4 abbreviation note in example prompts
- agents.md: Added INCLUDE_SHELL note to Foundation Milestone Definition
- agents.md: Added hookify/README.md reference in Full Documentation
- agents.md: Documented SKILL.md custom format (non-standard frontmatter)
- section/clarifying-questions.md: Renamed to "Section-Specific Backend Logic"
- data-model.md: Added cross-reference to agents.md Four Pillars

FALSE POSITIVES IDENTIFIED (11):
- Issues buildermethods#1, buildermethods#2, buildermethods#4-7, buildermethods#10, buildermethods#12, buildermethods#14, buildermethods#15, #17 already properly implemented

MODIFIED FILES:
- .claude/commands/design-os/export-product.md
- .claude/commands/design-os/data-model.md
- .claude/templates/design-os/section/clarifying-questions.md
- agents.md
- FORK_CHANGELOG.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant