Desenvolvimento com IA

O projeto oferece instruções para agentes de desenvolvimento, uma base de conhecimento de design e roteiros de auditoria. Esses recursos ajudam a manter alterações consistentes com a arquitetura existente.

Arquivos de instruções

Arquivo	Ferramenta	Finalidade
AGENTS.md	Codex, Cursor e outros agentes	Arquitetura, regras e comandos de verificação
.cursor/rules/*.mdc	Cursor	Regras de arquitetura e design
.cursor/hooks/ e .cursor/hooks.json	Cursor	Verificações de convenções
.windsurfrules	Windsurf	Instruções no formato do Windsurf
.github/copilot-instructions.md	GitHub Copilot	Instruções do projeto
.agents/skills/ e .agent-skills.lock.md	Agentes com suporte a skills	Recursos revisados e versões fixadas

Base de conhecimento de design

• system/globals/: cores, tipografia, espaçamento, interação, imagens, efeitos, responsividade, acessibilidade e catálogo de componentes. Leia antes de alterar a interface.
• src/config/site.config.ts: valores da marca traduzidos para tokens.
• src/registry.json: catálogo de componentes, seções e páginas.

A arquitetura tem três níveis: componentes em src/components/ui/**, seções em src/components/sections/** e páginas em src/pages/**. Páginas compõem seções, e seções compõem componentes.

Regras principais

• Utilize tokens para cores, espaçamento e tipografia. Evite cores literais e classes de paleta do Tailwind nos componentes.
• Preserve o tema escuro por meio da classe .dark e dos tokens correspondentes.
• Mantenha português do Brasil, Cloudflare Pages, SEO, Open Graph, RSS, sitemap, Pagefind e Starlight.
• Mantenha conteúdo nas coleções e textos institucionais na configuração apropriada. Consulte gestão de conteúdo.

Verificação

pnpm build
pnpm lint
pnpm run check:kpis
pnpm run lint:css

Instruções para uma tarefa

Leia AGENTS.md e system/globals/ antes de editar.
Adicione uma seção à página inicial reutilizando componentes e tokens existentes.
Mantenha o tema escuro e os textos em português do Brasil.
Execute pnpm build e pnpm lint.

Roteiros de auditoria

Os arquivos em system/prompts/ podem ser utilizados para revisar o projeto:

Roteiro	Verificação
tokens.md	Cores literais e uso de tokens
accessibility.md	Teclado, foco, textos alternativos e estrutura
responsive.md	Layout entre 375 e 1920 pixels
darkmode.md	Contraste e consistência no tema escuro
performance.md	Componentes interativos, recursos e desempenho
seo.md	Metadados, Open Graph, sitemap e dados estruturados

Exemplo:

Execute a auditoria de system/prompts/accessibility.md em src/pages/contact.astro
Apresente correções concretas com referências ao arquivo e à linha.

Revisão de skills

As skills do projeto ficam em .agents/skills/. O conjunto revisado é registrado em .agent-skills.lock.md, utilizado pela verificação de skills no fluxo de integração. Atualize o arquivo de versões ao adicionar ou alterar uma skill.