Feat/ai standards

[lucvysk]

What is the purpose of this pull request?

setup ai standards

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Requires change to documentation, which has been updated accordingly.

[vtex-io-ci-cd]

Hi! I'm VTEX IO CI/CD Bot and I'll be helping you to publish your app! 🤖

Please select which version do you want to release:

• Patch (backwards-compatible bug fixes)

• Minor (backwards-compatible functionality)

• Major (incompatible API changes)

And then you just need to merge your PR when you are ready! There is no need to create a release commit/tag.

• No thanks, I would rather do it manually 😞

[fdaciuk]

Ótimo trabalho — AGENTS.md detalhado, constitution sólida, rules específicas. PR atinge L1 e L2. Alguns ajustes antes de mergear:

🔴 CLAUDE.md deve ser symlink, não cópia

Atualmente é um arquivo regular (mode 100644) com conteúdo idêntico ao AGENTS.md. Com o tempo os dois vão divergir. O correto:

rm CLAUDE.md
ln -s AGENTS.md CLAUDE.md
git add CLAUDE.md

O diff deveria mostrar mode 120000 com conteúdo AGENTS.md.

---

🟡 Symlinks auto-referenciais em .agents/

Os arquivos .agents/commands/commands, .agents/rules/rules e .agents/skills/skills apontam cada um para o próprio diretório pai. São loops circulares que podem causar comportamento inesperado em ferramentas que percorrem o diretório recursivamente. Remover os três.

---

🟡 AGENTS.md não declara MCPs esperados

Para um repo com consumidores externos (vtex.omnishipping, vtex.shipping-preview), seria útil indicar o GitHub MCP para busca cross-repo antes de breaking changes — conforme recomendado no guia para AGENTS.md detailed.

[lucvysk]

CLAUDE.md deve ser symlink, não cópia

done

[sonar-workflows]

Quality Gate failed

• 4.35% Duplicated Lines (%) on New Code (is greater than 3.00%)

Project ID: address-form

View in SonarQube