Kiro .kiro/steering/

DESIGN.md + Kiro

Referência de configuração: Copiar DESIGN.md para steering

Pré-requisitos

  • Kiro instalado e configurado
  • Projeto com repositório Git inicializado
  • Um arquivo DESIGN.md — copie da biblioteca ou gere com a skill design-md

Configuração

1. Criar o diretório steering

O Kiro usa o diretório .kiro/steering/ para arquivos de contexto persistente. Crie a estrutura:

meu-projeto/
├── .kiro/
│   └── steering/
│       └── DESIGN.md
├── src/
└── ...

2. Copiar o DESIGN.md para steering

Copie o DESIGN.md para dentro do diretório steering:

mkdir -p .kiro/steering
cp DESIGN.md .kiro/steering/DESIGN.md

O Kiro inclui automaticamente todos os arquivos de .kiro/steering/ no contexto de cada interação. Não é necessário referenciar o arquivo manualmente — o agente já lê.

3. Verificar a configuração

Peça ao Kiro para gerar um componente:

Crie um card de produto seguindo as regras visuais do steering

O Kiro deve aplicar as cores, tipografia e espaçamentos definidos no DESIGN.md automaticamente.

4. Manter sincronizado

Se você editar o DESIGN.md na raiz do projeto, lembre de atualizar a cópia no steering:

cp DESIGN.md .kiro/steering/DESIGN.md

Alternativa: mantenha apenas a versão no steering e crie um symlink na raiz se outros agentes também precisarem ler.

Troubleshooting

  • Kiro não aplica as regras — verifique se o arquivo está em .kiro/steering/DESIGN.md (não em .kiro/DESIGN.md ou na raiz). O Kiro só carrega automaticamente arquivos dentro de steering/.
  • Regras parcialmente aplicadas — o DESIGN.md pode ser grande demais para o context window. Priorize as seções mais importantes (Colors, Typography, Components, Do’s and Don’ts) no início do arquivo.
  • Conflito com outros steering files — se houver instruções conflitantes em outros arquivos de steering, o Kiro pode ficar confuso. Mantenha o DESIGN.md como única fonte de regras visuais.
  • Versão desatualizada — se editou o DESIGN.md na raiz mas esqueceu de copiar para steering, o Kiro usa a versão antiga. Automatize com um script de sync.

Combinações úteis

  • DESIGN.md + specs Kiro — o Kiro tem um sistema de specs (requirements, design, tasks). Use o DESIGN.md no steering para regras visuais persistentes e as specs para funcionalidades específicas. São complementares.
  • Múltiplos steering files — além do DESIGN.md, adicione outros arquivos de contexto: AGENTS.md para convenções de código, API.md para padrões de API. O Kiro carrega todos automaticamente.
  • Steering + hooks — combine o DESIGN.md com hooks do Kiro para validar automaticamente se componentes gerados seguem o design system. Um hook postToolUse pode revisar o código gerado contra as regras do DESIGN.md.

Links úteis