hig-project-context

Visão geral da skill hig-project-context

hig-project-context ajuda você a criar ou atualizar um arquivo compartilhado de contexto de design Apple para que outras skills HIG consigam dar orientações mais específicas, com menos perguntas repetidas. É a melhor opção para times de apps Apple, fluxos de trabalho de codificação com Claude e autores de skills que querem uma única fonte de verdade para escopo do projeto, plataformas e restrições de design.

O principal objetivo é simples: capturar o contexto do projeto uma vez em .claude/apple-design-context.md e depois reutilizá-lo em outras skills HIG, como hig-foundations, hig-platforms, hig-components-*, hig-inputs e hig-technologies. Isso a torna útil ao iniciar um novo projeto para plataformas Apple ou quando o agente precisa de uma forma limpa de perguntar apenas pelos detalhes que faltam.

O que a hig-project-context realmente faz

hig-project-context é uma skill de coleta e escrita de contexto, não um gerador de design de interface. Ela analisa o repositório em busca de sinais como conteúdo do README, configurações de plataforma em package ou Xcode, Info.plist, frameworks usados no código, asset catalogs e pistas de acessibilidade, e então pede ao usuário para confirmar ou corrigir o que encontrou.

Por que as pessoas instalam

Instale hig-project-context quando quiser menos vai-e-volta e uma orientação Apple mais consistente ao longo do projeto. Ela é especialmente útil se você já está cansado de responder às mesmas perguntas de plataforma, produto e tecnologia toda vez que uma nova tarefa ligada ao HIG começa.

Casos de melhor encaixe e de não encaixe

Essa skill funciona melhor em projetos que já têm código ou metadados de repositório para inspecionar. Ela é menos útil para uma ideia em branco, um produto que não seja Apple ou um prompt único em que você não precise de contexto compartilhado e reutilizável.

Como usar a skill hig-project-context

Instale e ative hig-project-context

Use o fluxo de instalação de skills do repositório e, depois, invoque hig-project-context quando quiser criar ou atualizar .claude/apple-design-context.md. Na prática, o passo hig-project-context install importa menos do que ter a skill disponível no seu fluxo de trabalho com Claude e apontá-la para a raiz correta do repositório.

Dê a entrada certa primeiro

A skill funciona melhor quando sua solicitação inclui um objetivo geral do projeto e o local do repositório. Bons prompts iniciais são específicos o suficiente para orientar a descoberta, mas não tão detalhados a ponto de esconder contexto que ainda falta.

Exemplo:

• “Use hig-project-context para criar um arquivo de contexto compartilhado para este app Apple. É um app de acompanhamento de saúde com SwiftUI e foco em iPhone.”
• “Execute hig-project-context neste repositório e me diga quais sinais de plataforma e framework você encontrar antes de escrever o arquivo de contexto.”

O que inspecionar antes de confiar no resultado

Comece com SKILL.md e depois verifique os arquivos do repositório que a skill foi projetada para ler: README.md, Package.swift, .xcodeproj, Info.plist e a própria base de código. O trecho do repositório não mostra pastas auxiliares, então a skill é intencionalmente leve; o valor está no fluxo de descoberta, não em um grande conjunto de regras de apoio.

Fluxo de trabalho que gera resultados mais limpos

Um padrão forte de hig-project-context usage é:

1. Deixe a skill coletar evidências do repositório.
2. Revise os sinais descobertos de produto, plataforma e framework.
3. Confirme ou corrija o contexto.
4. Salve o resultado em .claude/apple-design-context.md.
5. Reutilize esse arquivo ao invocar outras skills HIG.

Essa sequência evita que as skills posteriores tenham de adivinhar o escopo da plataforma, que é justamente onde muitos erros de orientação Apple começam.

FAQ da skill hig-project-context

hig-project-context é só para projetos novos?

Não. Ela também é útil para repositórios existentes que nunca tiveram um arquivo compartilhado de contexto de design Apple ou que foram saindo do padrão com o tempo. Se o time fica reexplicando as mesmas perguntas de configuração, essa skill pode padronizar esse contexto.

Em que isso é diferente de um prompt normal?

Um prompt normal pode pedir detalhes de plataforma uma vez. hig-project-context é um fluxo de trabalho reutilizável para descobrir, confirmar e armazenar o contexto do projeto, para que as próximas skills HIG possam confiar nele em vez de recomeçar do zero.

Iniciantes precisam conhecer Apple HIG antes?

Não, mas precisam de um repositório real ou pelo menos de um projeto-alvo concreto. A skill é amigável para iniciantes no sentido de fazer as perguntas certas de descoberta, mas ela não substitui a falta de conhecimento do produto.

Quando eu não devo usar?

Não use hig-project-context se sua tarefa não estiver ligada a orientação de design Apple, se não houver um repositório para inspecionar ou se você só precisar de uma resposta pontual sem criar contexto compartilhado.

Como melhorar a skill hig-project-context

Forneça sinais de origem mais fortes

A qualidade de hig-project-context depende do que ela consegue verificar. Dê a ela a raiz do repositório, mencione as plataformas Apple pretendidas e sinalize escolhas de framework já conhecidas, como SwiftUI, UIKit, HealthKit ou widgets, se isso não ficar óbvio pelo código.

Confirme o contexto, não apenas aceite

O comportamento mais útil de hig-project-context guide é revisar e corrigir, não automatizar às cegas. Se a skill inferir a plataforma-alvo errada, a faixa de implantação ou a categoria do app, corrija isso imediatamente para que as skills posteriores herdem um contexto preciso.

Alimente as decisões que ainda faltam

Se a primeira passada ficar incompleta, acrescente os fatos que mais importam para a orientação de design: propósito do produto em uma frase, dispositivos-alvo, versões mínimas de sistema, capacidades principais e quaisquer restrições de acessibilidade. Esses são os detalhes que mudam a forma como outras skills HIG devem responder.

Reutilize o arquivo e atualize-o quando o escopo mudar

O maior modo de falha é contexto desatualizado. Atualize .claude/apple-design-context.md quando o app adicionar uma plataforma, trocar de framework de UI ou mudar seu caso de uso central; caso contrário, hig-project-context for Skill Authoring continuará propagando suposições antigas para orientações futuras.