Criar Registro de Decisão Arquitetural

Crie um documento de ADR para ${input:DecisionTitle} usando formatação estruturada otimizada para consumo por IA e legibilidade humana.

Entradas

• Contexto: ${input:Context}
• Decisão: ${input:Decision}
• Alternativas: ${input:Alternatives}
• Partes Interessadas: ${input:Stakeholders}

Validação de Entrada

Se alguma das entradas necessárias não for fornecida ou não puder ser determinada a partir do histórico da conversa, peça ao usuário para fornecer as informações faltantes antes de prosseguir com a geração do ADR.

Requisitos

• Use linguagem precisa e sem ambiguidade
• Siga o formato padronizado de ADR com front matter
• Inclua consequências positivas e negativas
• Documente alternativas com justificativa de rejeição
• Estruture para análise por máquina e referência humana
• Use marcadores codificados (códigos de 3-4 letras + números de 3 dígitos) para seções com múltiplos itens

O ADR deve ser salvo no diretório /docs/adr/ usando a convenção de nomenclatura: adr-NNNN-[title-slug].md, onde NNNN é o próximo número sequencial de 4 dígitos (por exemplo, adr-0001-database-selection.md).

Estrutura de Documentação Necessária

O arquivo de documentação deve seguir o modelo abaixo, garantindo que todas as seções sejam preenchidas adequadamente. O front matter do markdown deve ser estruturado corretamente conforme o exemplo a seguir:

---
title: "ADR-NNNN: [Decision Title]"
status: "Proposed"
date: "YYYY-MM-DD"
authors: "[Stakeholder Names/Roles]"
tags: ["architecture", "decision"]
supersedes: ""
superseded_by: ""
---

# ADR-NNNN: [Decision Title]

## Status

**Proposed** | Accepted | Rejected | Superseded | Deprecated

## Context

[Problem statement, technical constraints, business requirements, and environmental factors requiring this decision.]

## Decision

[Chosen solution with clear rationale for selection.]

## Consequences

### Positive

- **POS-001**: [Beneficial outcomes and advantages]
- **POS-002**: [Performance, maintainability, scalability improvements]
- **POS-003**: [Alignment with architectural principles]

### Negative

- **NEG-001**: [Trade-offs, limitations, drawbacks]
- **NEG-002**: [Technical debt or complexity introduced]
- **NEG-003**: [Risks and future challenges]

## Alternatives Considered

### [Alternative 1 Name]

- **ALT-001**: **Description**: [Brief technical description]
- **ALT-002**: **Rejection Reason**: [Why this option was not selected]

### [Alternative 2 Name]

- **ALT-003**: **Description**: [Brief technical description]
- **ALT-004**: **Rejection Reason**: [Why this option was not selected]

## Implementation Notes

- **IMP-001**: [Key implementation considerations]
- **IMP-002**: [Migration or rollout strategy if applicable]
- **IMP-003**: [Monitoring and success criteria]

## References

- **REF-001**: [Related ADRs]
- **REF-002**: [External documentation]
- **REF-003**: [Standards or frameworks referenced]