kata-sample

---
name: kata-sample
description: "Template de Kata (skill repetível). Use como referência para criar novos procedimentos padronizados que agentes de IA executam de forma recorrente."
---

# Kata: [Nome do Procedimento]

> **Prefixo:** `kata-` | **Tipo:** Skill Repetível | **Escopo:** [Etapa do SDLC]

## Objetivo

Descreva o que este procedimento produz. Katas são procedimentos estruturados que definem como agentes de IA executam tarefas recorrentes de forma padronizada, com inputs, outputs e critérios de validação.

## Quando Usar

- [Condição de ativação 1 — ex: quando o usuário pede para criar um ADR]
- [Condição de ativação 2 — ex: quando uma decisão arquitetural é tomada]
- [Condição de ativação 3 — ex: quando um PR modifica a estrutura do sistema]

## Inputs

| Input | Obrigatório | Descrição |
|-------|:-----------:|-----------|
| [Input 1] | Sim | [ex: descrição da decisão arquitetural] |
| [Input 2] | Sim | [ex: contexto do problema] |
| [Input 3] | Não | [ex: alternativas já consideradas] |

## Workflow

Copie este checklist e acompanhe o progresso:

```
Progresso:
- [ ] 1. [Nome do passo 1]
- [ ] 2. [Nome do passo 2]
- [ ] 3. [Nome do passo 3]
- [ ] 4. Validação final
```

### Passo 1: [Nome do Passo]

[Instruções detalhadas do que o agente deve fazer neste passo]

1. [Sub-ação 1]
2. [Sub-ação 2]
3. [Sub-ação 3]

### Passo 2: [Nome do Passo]

[Instruções detalhadas]

### Passo 3: [Nome do Passo]

[Instruções detalhadas]

### Passo 4: Validação Final

Antes de entregar o output, verifique:

- [ ] [Critério de qualidade 1]
- [ ] [Critério de qualidade 2]
- [ ] [Critério de qualidade 3]

## Outputs

| Output | Formato | Destino |
|--------|---------|---------|
| [Output 1] | [Markdown / YAML / código] | [ex: docs/adrs/] |
| [Output 2] | [Formato] | [Local de destino] |

## Exemplo de Execução

### Input de Exemplo

```
[Exemplo concreto de input que ativa este Kata]
```

### Output de Exemplo

```
[Exemplo concreto do output produzido]
```

## Restrições

- [Restrição 1 — ex: nunca alterar ADRs já aprovados]
- [Restrição 2 — ex: sempre usar português brasileiro]
- [Restrição 3 — ex: referenciar Lexis aplicáveis]

---

**Modelo:** Este arquivo é um template. Para criar um novo Kata, copie este arquivo e substitua os campos entre colchetes.