Write design

Skill cleudice/kiro-ai-team/skills/write-design

Gera .kiro/specs/<slug>/design.md — arquitetura da mudança, contratos públicos completos (base do teste black-box), decisões com alternativa descartada e raio de impacto. Use após requirements aprovado, ou quando pedirem 'design', 'arquitetura da mudança', 'defina os contratos/endpoints'.From its SKILL.md

Install

npx -y skills add cleudice/kiro-ai-team --skill write-design

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.3 KB, 587 tokens by cl100k_base, as published. Nobody here has run it

write-design

Passos

Ler requirements.md aprovado + docs/context/ (eixos architecture/conventions) + tech.md do projeto.
Definir: componentes tocados, contratos públicos (interfaces/endpoints/procedures) com assinaturas, modelo de dados, fluxo de erro.
Registrar cada decisão relevante como "Decisão: X. Alternativa descartada: Y. Motivo: Z."
Mapear raio de impacto: quem chama, o que pode regredir.

Saída — .kiro/specs/<slug>/design.md

# Design — <slug>   (PBI: <id>)
## Visão
<3-6 linhas: a forma da mudança e por quê essa forma>
## Contratos públicos   <!-- fonte ÚNICA do qa-blackbox; ele nunca lê src/ -->
### <endpoint|interface|procedure|tela>
- Assinatura: <método+rota | assinatura completa | nome+parâmetros com tipos>
- Entrada: <campos, tipos, obrigatoriedade, validações>
- Saída (sucesso): <shape exato, códigos/status>
- Saída (erro): <cada erro possível: condição → código/mensagem observável>
- Cobre: R1.1, R1.2, ...   <!-- todo R#.# do requirements aparece em algum contrato -->
## Modelo de dados
<tabelas/coleções tocadas, campos novos, migração + rollback se houver>
## Decisões
- Decisão: <X>. Alternativa descartada: <Y>. Motivo: <Z>.
## Raio de impacto
<quem chama o que muda; o que pode regredir; onde o G5 deve olhar>
## Estratégia de teste
<como o qa-blackbox exercita cada contrato sem ler src/: fixtures, ambiente, dados>

"Contrato completo" = um QA consegue escrever o teste só com esta seção: assinatura + entrada + toda saída de sucesso E de erro + qual R#.# cobre. Contrato sem os erros mapeados ou sem Cobre: está incompleto — o black-box vai inventar ou pular.

Regras

Contratos públicos completos são obrigatórios — é o que permite testes black-box sem ler src/. Critério R#.# sem contrato que o cubra = design incompleto, voltar antes de seguir pro write-tasks.
Design que contradiz um requisito = voltar ao write-requirements, não contornar.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.