Skill

adr

Use quando uma decisão arquitetural importante precisa ser registrada com mais detalhes do que o formato padrão do DECISIONS.md. Ativado por: "registrar decisão", "ADR", decisões sobre banco de dados, frameworks, padrões arquiteturais, infraestrutura.

Install

npx claudepluginhub souzalemos/spec-driven-workflow --plugin spec-driven-workflow

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Para decisões de alto impacto que afetam a arquitetura do projeto:

SKILL.md

Similar Skills

kotlin-ktor-patterns

Provides Ktor server patterns for routing DSL, plugins (auth, CORS, serialization), Koin DI, WebSockets, services, and testApplication testing.

everything-claude-code

163.2k

deep-research

Conducts multi-source web research with firecrawl and exa MCPs: searches, scrapes pages, synthesizes cited reports. For deep dives, competitive analysis, tech evaluations, or due diligence.

everything-claude-code

163.2k

inventory-demand-planning

Provides demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation for multi-location retailers managing 300-800 SKUs.

everything-claude-code

163.2k

Stats

Stars1

Forks0

Last CommitApr 6, 2026

Actions

View Source View Plugin View on GitHub View README

Skill de Architecture Decision Record (ADR)

Quando usar

Para decisões de alto impacto que afetam a arquitetura do projeto:

Escolha de framework, banco, ORM, auth strategy

Padrões arquiteturais (monolito vs microserviço, REST vs GraphQL)

Decisões de infraestrutura (cloud, CI/CD, deploy)

Mudanças que são caras de reverter

Para decisões menores, o formato padrão do DECISIONS.md é suficiente.

Processo

1. Contexto

Entenda o problema que exige decisão. Se necessário, delegue ao subagent researcher para pesquisar opções.

2. Criar ADR

Crie .spec/adrs/ADR-0xx-[titulo-kebab-case].md:

# ADR-0xx: [Título da Decisão] ## Status Proposta | Aceita | Deprecada | Substituída por ADR-0yy ## Data YYYY-MM-DD ## Autoria - **Proposta por:** [humano | Claude | colaboração] - **Aprovada por:** [humano] ## Contexto [Descrição detalhada do problema e por que uma decisão é necessária. Inclua restrições técnicas, requisitos de negócio e contexto do time.] ## Opções Consideradas ### Opção 1: [Nome] - **Descrição:** [Como funcionaria] - **Prós:** - [vantagem 1] - [vantagem 2] - **Contras:** - [desvantagem 1] - [desvantagem 2] - **Estimativa de esforço:** [baixo/médio/alto] ### Opção 2: [Nome] - **Descrição:** [Como funcionaria] - **Prós:** ... - **Contras:** ... ### Opção 3: [Nome] ... ## Decisão [Qual opção foi escolhida e POR QUÊ] ## Consequências ### Positivas - [Benefício 1] - [Benefício 2] ### Negativas - [Trade-off 1] - [Trade-off 2] ### Riscos - [Risco 1 — mitigação: ...] ## Notas de Implementação [Como esta decisão afeta o código. Quais padrões seguir. O que evitar. Referências a docs ou exemplos.]

3. Registrar

Adicione uma entrada resumida em DECISIONS.md apontando para o ADR

Se o ADR afeta o milestone atual, atualize o ROADMAP.md se necessário

4. Informar

"ADR-0xx registrado. Decisão: [resumo em uma linha]."

Skill de Architecture Decision Record (ADR)

Quando usar

Para decisões de alto impacto que afetam a arquitetura do projeto:

Escolha de framework, banco, ORM, auth strategy
Padrões arquiteturais (monolito vs microserviço, REST vs GraphQL)
Decisões de infraestrutura (cloud, CI/CD, deploy)
Mudanças que são caras de reverter

Para decisões menores, o formato padrão do DECISIONS.md é suficiente.

Processo

1. Contexto

Entenda o problema que exige decisão. Se necessário, delegue ao subagent researcher para pesquisar opções.

2. Criar ADR

Crie .spec/adrs/ADR-0xx-[titulo-kebab-case].md:

# ADR-0xx: [Título da Decisão]

## Status
Proposta | Aceita | Deprecada | Substituída por ADR-0yy

## Data
YYYY-MM-DD

## Autoria
- **Proposta por:** [humano | Claude | colaboração]
- **Aprovada por:** [humano]

## Contexto
[Descrição detalhada do problema e por que uma decisão é necessária.
Inclua restrições técnicas, requisitos de negócio e contexto do time.]

## Opções Consideradas

### Opção 1: [Nome]
- **Descrição:** [Como funcionaria]
- **Prós:**
  - [vantagem 1]
  - [vantagem 2]
- **Contras:**
  - [desvantagem 1]
  - [desvantagem 2]
- **Estimativa de esforço:** [baixo/médio/alto]

### Opção 2: [Nome]
- **Descrição:** [Como funcionaria]
- **Prós:** ...
- **Contras:** ...

### Opção 3: [Nome]
...

## Decisão
[Qual opção foi escolhida e POR QUÊ]

## Consequências

### Positivas
- [Benefício 1]
- [Benefício 2]

### Negativas
- [Trade-off 1]
- [Trade-off 2]

### Riscos
- [Risco 1 — mitigação: ...]

## Notas de Implementação
[Como esta decisão afeta o código. Quais padrões seguir.
O que evitar. Referências a docs ou exemplos.]

3. Registrar

Adicione uma entrada resumida em DECISIONS.md apontando para o ADR
Se o ADR afeta o milestone atual, atualize o ROADMAP.md se necessário

4. Informar

"ADR-0xx registrado. Decisão: [resumo em uma linha]."