docs(web): add design context for marketplace web app

[amondnet]

Summary

• Add .impeccable.md with full design context for the marketplace web app
• Reference .impeccable.md from CLAUDE.md under a new "Design Context" section
• Document five key design principles for apps/web/

Design Principles Added

1. Content-first clarity -- Plugin name, description, and install action should be instantly scannable.
2. Trust through polish -- Consistent spacing, aligned elements, and refined details.
3. Efficient discovery -- Users should find what they need in seconds.
4. Inclusive by default -- WCAG AA, reduced motion, light/dark mode, Korean + English.
5. Design system loyalty -- Use Nuxt UI components and Tailwind as intended. Consistency over novelty.

Test Plan

• Verify .impeccable.md is present and readable at repo root
• Verify CLAUDE.md references .impeccable.md correctly in the Design Context section

---

Summary by cubic

Adds .impeccable.md with full design context for the marketplace web app and links it from CLAUDE.md. This clarifies users, brand, aesthetic, and five principles guiding apps/web/ UI/UX.

• New Features
  • Added .impeccable.md (users, brand personality, aesthetic direction, five design principles for apps/web/).
  • Updated CLAUDE.md with a "Design Context" section that links to .impeccable.md and summarizes the principles.

^{Written for commit 6426d56. Summary will update on new commits.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
claude-code-plugins	Ready	Preview, Comment	Mar 28, 2026 3:38pm

[gemini-code-assist]

Code Review

This pull request introduces a new design context document in .impeccable.md and updates CLAUDE.md to reference it. The reviewer suggested removing the duplicated design principles from CLAUDE.md to maintain a single source of truth in .impeccable.md, which improves documentation maintainability.

[cubic-dev-ai]

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant Dev as Developer / User
    participant Web as Marketplace (apps/web)
    participant Design as Nuxt UI & Tailwind
    participant Registry as Plugin Registry
    participant Claude as Claude Code (MCP)

    Note over Web,Design: NEW: Principles applied to UI Architecture
    
    Dev->>Web: Access Marketplace
    
    rect rgb(240, 240, 240)
        Note right of Web: Inclusive by default
        Web->>Design: NEW: Apply Locale (EN/KR)
        Web->>Design: NEW: Apply Theme (Light/Dark)
    end

    Web->>Registry: Fetch available plugins
    Registry-->>Web: Plugin Metadata (JSON)

    Note over Web: Content-first clarity
    Web->>Web: Render scannable plugin cards
    Web->>Design: Use Nuxt UI components (Loyalty)

    alt Efficient Discovery
        Dev->>Web: Search / Filter request
        Web->>Web: Refine view instantly
    end

    Note over Dev,Web: Trust through polish
    Dev->>Web: Review Plugin Details & Author
    
    alt Installation Flow
        Dev->>Web: Click "Install" Action
        Web->>Claude: NEW: Register plugin via MCP interface
        Claude-->>Web: Confirmation
        Web-->>Dev: Success notification
    end

    Note over Web,Claude: Design context ensures consistent trust signals

Loading