Skip to content

Integrate Claude Design exports (handoff bundle + HTML) into brique/agamotto #89

@izo

Description

@izo

Contexte

Claude Design (Anthropic Labs, 17 avril 2026) est un outil de création visuelle piloté par Opus 4.7 vision. Correction de l'analyse initiale : les exports sont utilisables dès maintenant en research preview (Pro/Max/Team/Enterprise), pas besoin d'attendre une API publique.

Formats d'export disponibles :

  • Handoff bundle — conçu explicitement pour être passé à Claude Code en une instruction
  • Standalone HTML — ingestible comme référence visuelle/markup
  • PDF / PPTX / DOCX — lisibles via Read tool
  • Canva URL / internal URLs — partageables dans le contexte session
  • Export Canva / PowerPoint — pour le design team, pas pour le code

Plan actionnable (P3, effort-M)

Phase 1 — Ingestion côté brique (frontend/01)

  • Ajouter détection d'input dans la Phase 0 de brique : Figma URL OU handoff bundle (path local) OU HTML standalone
  • Pattern de détection :
    • *.zip / dossier avec manifest → handoff bundle
    • *.html avec markers Claude Design → import HTML
    • figma.com/* → flux Figma existant (inchangé)
  • Documenter le workflow dans agents/frontend/01-brique.md Phase 0.5

Phase 2 — Export côté agamotto (17)

  • agamotto produit déjà DESIGN.md (ULK-108). Ajouter un mode agamotto --export claude-design qui génère un bundle compatible avec l'import team design system de Claude Design (format à reverse-engineer depuis un export réel).

Phase 3 — Skill bundle

  • community-skills/claude-design/ avec 2 skills :
    • claude-design-import — guide pour passer un handoff bundle à brique
    • claude-design-export — guide pour exporter DESIGN.md vers Claude Design
  • Flag ./install.sh --with-claude-design-skills (opt-in)

Phase 4 — Protocole partagé

  • agents/_shared/claude-design-protocol.md — équivalent de figma-protocol.md
  • Mise à jour frontend-agents.md : sources supportées = Figma + Claude Design

Questions ouvertes (à lever sur un vrai export)

  • Schéma réel du handoff bundle (manifest ? tokens design ? assets ?)
  • Claude Design accepte-t-il un DESIGN.md en import direct ?
  • Le HTML exporté contient-il des attributs sémantiques (data-component-id, etc.) exploitables par brique ?

Références

Acceptance

  • Pattern de détection handoff bundle / HTML dans brique Phase 0
  • Test sur un export réel (capture écran + fichier archivé dans docs/analysis/claude-design-samples/)
  • Mode export agamotto (si schéma import Claude Design documenté)
  • Protocole _shared/claude-design-protocol.md créé
  • Opt-in skills claude-design-* bundlés (sur le pattern Figma)

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions