Criar Documento de Spike Técnico

Crie documentos de "spike" técnico com tempo limitado para pesquisar questões críticas que precisam ser respondidas antes que o desenvolvimento possa prosseguir. Cada spike foca em uma decisão técnica específica com entregas e prazos claros.

Estrutura do Documento

Crie arquivos individuais no diretório ${input:FolderPath|docs/spikes}. Nomeie cada arquivo usando o padrão: [category]-[short-description]-spike.md (por exemplo, api-copilot-integration-spike.md, performance-realtime-audio-spike.md).

---
title: "${input:SpikeTitle}"
category: "${input:Category|Technical}"
status: "🔴 Not Started"
priority: "${input:Priority|High}"
timebox: "${input:Timebox|1 week}"
created: [YYYY-MM-DD]
updated: [YYYY-MM-DD]
owner: "${input:Owner}"
tags: ["technical-spike", "${input:Category|technical}", "research"]
---

# ${input:SpikeTitle}

## Summary

**Spike Objective:** [Clear, specific question or decision that needs resolution]

**Why This Matters:** [Impact on development/architecture decisions]

**Timebox:** [How much time allocated to this spike]

**Decision Deadline:** [When this must be resolved to avoid blocking development]

## Research Question(s)

**Primary Question:** [Main technical question that needs answering]

**Secondary Questions:**

- [Related question 1]
- [Related question 2]
- [Related question 3]

## Investigation Plan

### Research Tasks

- [ ] [Specific research task 1]
- [ ] [Specific research task 2]
- [ ] [Specific research task 3]
- [ ] [Create proof of concept/prototype]
- [ ] [Document findings and recommendations]

### Success Criteria

**This spike is complete when:**

- [ ] [Specific criteria 1]
- [ ] [Specific criteria 2]
- [ ] [Clear recommendation documented]
- [ ] [Proof of concept completed (if applicable)]

## Technical Context

**Related Components:** [List system components affected by this decision]

**Dependencies:** [What other spikes or decisions depend on resolving this]

**Constraints:** [Known limitations or requirements that affect the solution]

## Research Findings

### Investigation Results

[Document research findings, test results, and evidence gathered]

### Prototype/Testing Notes

[Results from any prototypes, spikes, or technical experiments]

### External Resources

- [Link to relevant documentation]
- [Link to API references]
- [Link to community discussions]
- [Link to examples/tutorials]

## Decision

### Recommendation

[Clear recommendation based on research findings]

### Rationale

[Why this approach was chosen over alternatives]

### Implementation Notes

[Key considerations for implementation]

### Follow-up Actions

- [ ] [Action item 1]
- [ ] [Action item 2]
- [ ] [Update architecture documents]
- [ ] [Create implementation tasks]

## Status History

| Date   | Status         | Notes                      |
| ------ | -------------- | -------------------------- |
| [Date] | 🔴 Not Started | Spike created and scoped   |
| [Date] | 🟡 In Progress | Research commenced         |
| [Date] | 🟢 Complete    | [Resolution summary]       |

---

_Last updated: [Date] by [Name]_

Categorias para Spikes Técnicos

Integração de API

• Capacidades e limitações de APIs de terceiros
• Padrões de integração e autenticação
• Limites de taxa e características de desempenho

Arquitetura e Design

• Decisões de arquitetura do sistema
• Aplicabilidade de padrões de design
• Modelos de interação de componentes

Desempenho e Escalabilidade

• Requisitos e restrições de desempenho
• Gargalos de escalabilidade e soluções
• Padrões de utilização de recursos

Plataforma e Infraestrutura

• Capacidades e limitações da plataforma
• Requisitos de infraestrutura
• Considerações de implantação e hospedagem

Segurança e Conformidade

• Requisitos e implementações de segurança
• Restrições de conformidade
• Abordagens de autenticação e autorização

Experiência do Usuário

• Padrões de interação do usuário
• Requisitos de acessibilidade
• Decisões de design de interface

Convenções de Nomenclatura de Arquivos

Use nomes descritivos em "kebab-case" que indiquem a categoria e a incógnita específica:

Exemplos de API/Integração:

• api-copilot-chat-integration-spike.md
• api-azure-speech-realtime-spike.md
• api-vscode-extension-capabilities-spike.md

Exemplos de Desempenho:

• performance-audio-processing-latency-spike.md
• performance-extension-host-limitations-spike.md
• performance-webrtc-reliability-spike.md

Exemplos de Arquitetura:

• architecture-voice-pipeline-design-spike.md

…