Apple HIG: Contexto do Projeto

Crie e mantenha .claude/apple-design-context.md para que outras habilidades do HIG possam pular perguntas redundantes.

Verifique .claude/apple-design-context.md antes de fazer perguntas. Use o contexto existente e peça apenas informações que ainda não foram abordadas.

Coleta de Contexto

Antes de fazer perguntas, descubra automaticamente o contexto a partir de:

1. README.md -- Descrição do produto, alvos de plataforma
2. Package.swift / .xcodeproj -- Plataformas suportadas, versões mínimas do sistema operacional, dependências
3. Info.plist -- Categoria do aplicativo, recursos necessários, orientações suportadas
4. Código existente -- Declarações de importação revelam frameworks (SwiftUI vs UIKit, HealthKit, etc.)
5. Assets.xcassets -- Recursos de cores, conjuntos de ícones, variantes de modo escuro
6. Auditoria de acessibilidade -- Grep para modificadores/atributos de acessibilidade

Apresente as descobertas e peça ao usuário para confirmar ou corrigir. Em seguida, colete o que ainda estiver faltando:

1. Visão Geral do Produto

• O que o aplicativo faz? (uma frase)
• Categoria (produtividade, social, saúde, jogo, utilitário, etc.)
• Estágio (conceito, desenvolvimento, lançado, redesenho)

2. Plataformas de Destino

• Quais plataformas Apple? (iOS, iPadOS, macOS, tvOS, watchOS, visionOS)
• Versões mínimas do sistema operacional
• Universal ou específico da plataforma?

3. Pilha de Tecnologia

• Framework de UI: SwiftUI, UIKit, AppKit ou misto?
• Arquitetura: janela única, várias janelas, baseado em documento?
• Tecnologias Apple em uso? (HealthKit, CloudKit, ARKit, etc.)

4. Sistema de Design

• Padrões do sistema ou sistema de design personalizado?
• Cores da marca, fontes, estilo de ícone?
• Suporte ao modo escuro e ao Dynamic Type

5. Requisitos de Acessibilidade

• Nível de destino (básico, aprimorado, abrangente)
• Considerações específicas (VoiceOver, Switch Control, etc.)
• Requisitos regulatórios (WCAG, Seção 508)

6. Contexto do Usuário

• Personas principais (1-3)
• Casos de uso e ambientes principais (mesa, em movimento, visualização rápida, imersivo)
• Pontos problemáticos conhecidos ou desafios de design

7. Recursos de Design Existentes

• Arquivos Figma/Sketch?
• Recursos de Design da Apple em uso?
• Biblioteca de componentes existente?

Modelo de Documento de Contexto

Gere .claude/apple-design-context.md usando esta estrutura:

# Apple Design Context

## Product
- **Name**: [App name]
- **Description**: [One sentence]
- **Category**: [Category]
- **Stage**: [Concept / Development / Shipped / Redesign]

## Platforms
| Platform | Supported | Min OS | Notes |
|----------|-----------|--------|-------|
| iOS      | Yes/No    |        |       |
| iPadOS   | Yes/No    |        |       |
| macOS    | Yes/No    |        |       |
| tvOS     | Yes/No    |        |       |
| watchOS  | Yes/No    |        |       |
| visionOS | Yes/No    |        |       |

## Technology
- **UI Framework**: [SwiftUI / UIKit / AppKit / Mixed]
- **Architecture**: [Single-window / Multi-window / Document-based]
- **Apple Technologies**: [List any: HealthKit, CloudKit, ARKit, etc.]

## Design System
- **Base**: [System defaults / Custom design system]
- **Brand Colors**: [List or reference]
- **Typography**: [System fonts / Custom fonts]
- **Dark Mode**: [Supported / Not yet / N/A]
- **Dynamic Type**: [Supported / Not yet / N/A]

## Accessibility
- **Target Level**: [Baseline / Enhanced / Comprehensive]
- **Key Considerations**: [List any specific needs]

## Users
- **Primary Persona**: [Description]
- **Key Use Cases**: [List]
- **Known Challenges**: [List]

Atualizando Contexto

Ao atualizar um documento de contexto existente:

1. Leia o .claude/apple-design-context.md atual
2. Pergunte o que mudou
3. Atualize apenas as seções alteradas
4. Preserve todas as informações inalteradas

Habilidades Relacionadas

• hig-platforms -- Orientações específicas da plataforma
• hig-foundations -- Decisões de cor, tipografia, layout
• hig-patterns -- Recomendações de padrões de UX
• hig-components-* -- Recomendações de componentes
• hig-inputs -- Cobertura de métodos de entrada
• hig-technologies -- Relevância da tecnologia Apple

Construído por Raintree Technology · Mais ferramentas para desenvolvedores

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.