create-adr — criação de ADR create-adr, acr-automotive, community, criação de ADR, ide skills, formato MADR, ferramentas de IA, decisões arquiteturais

v1.0.0
GitHub

Sobre este Skill

Perfeito para Agentes de Análise Arquitetônica que necessitam de criação e gerenciamento de Registros de Decisões Arquitetônicas padronizados usando o formato MADR. O create-adr é uma habilidade que cria ADRs no formato MADR

Recursos

Criação de ADRs no formato MADR
Confirmação de número de ADR
Sugestão de status 'Deprecado' ao excluir ADR
Confirmação de substituição de ADR
Interação inteligente para criar ADRs

# Tópicos principais

criação de ADR formato MADR ferramentas de IA decisões arquiteturais
amak07 amak07
[1]
[0]
Atualizado: 3/13/2026

Skill Overview

Start with fit, limitations, and setup before diving into the repository.

Perfeito para Agentes de Análise Arquitetônica que necessitam de criação e gerenciamento de Registros de Decisões Arquitetônicas padronizados usando o formato MADR. O create-adr é uma habilidade que cria ADRs no formato MADR

Por que usar essa habilidade

Habilita os agentes a criar, gerenciar e substituir Registros de Decisões Arquitetônicas usando o formato MADR, fornecendo um acompanhamento crucial de decisões e contexto para referência futura, e suportando recursos como números de ADR sugeridos automaticamente e sugestões de status 'Descontinuado'.

Melhor para

Perfeito para Agentes de Análise Arquitetônica que necessitam de criação e gerenciamento de Registros de Decisões Arquitetônicas padronizados usando o formato MADR.

↓ Casos de Uso Práticos for create-adr

Criar novos ADRs com números sugeridos automaticamente
Gerenciar ADRs existentes por meio de exclusão e substituição
Analizar o histórico de decisões e contexto para escolhas arquitetônicas informadas

! Segurança e Limitações

  • Exige confirmação do usuário para criação, exclusão e substituição de ADR
  • Limitado ao formato MADR para criação de ADR

About The Source

The section below is adapted from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Demo Labs

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ e etapas de instalação

These questions and steps mirror the structured data on this page for better search understanding.

? Perguntas frequentes

O que é create-adr?

Perfeito para Agentes de Análise Arquitetônica que necessitam de criação e gerenciamento de Registros de Decisões Arquitetônicas padronizados usando o formato MADR. O create-adr é uma habilidade que cria ADRs no formato MADR

Como instalar create-adr?

Execute o comando: npx killer-skills add amak07/acr-automotive. Ele funciona com Cursor, Windsurf, VS Code, Claude Code e mais de 19 outros IDEs.

Quais são os casos de uso de create-adr?

Os principais casos de uso incluem: Criar novos ADRs com números sugeridos automaticamente, Gerenciar ADRs existentes por meio de exclusão e substituição, Analizar o histórico de decisões e contexto para escolhas arquitetônicas informadas.

Quais IDEs são compatíveis com create-adr?

Esta skill é compatível com Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use a CLI do Killer-Skills para uma instalação unificada.

create-adr tem limitações?

Exige confirmação do usuário para criação, exclusão e substituição de ADR. Limitado ao formato MADR para criação de ADR.

↓ Como instalar este skill

  1. 1. Abra o terminal

    Abra o terminal ou linha de comando no diretório do projeto.

  2. 2. Execute o comando de instalação

    Execute: npx killer-skills add amak07/acr-automotive. A CLI detectará sua IDE ou agente automaticamente e configurará a skill.

  3. 3. Comece a usar o skill

    O skill já está ativo. Seu agente de IA pode usar create-adr imediatamente no projeto atual.

! Source Notes

This page is still useful for installation and source reference. Before using it, compare the fit, limitations, and upstream repository notes above.

Upstream Repository Material

The section below is adapted from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Upstream Source

create-adr

Install create-adr, an AI agent skill for AI agent workflows and automation. Explore features, use cases, limitations, and setup guidance.

SKILL.md
Readonly
Upstream Repository Material
The section below is adapted from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.
Upstream Source

ADR Creation Skill

Purpose

Create Architecture Decision Records (ADRs) using the MADR (Markdown Any Decision Records) format. ADRs capture important architectural decisions and their context for future reference.

Smart Interaction

ASK the User When:

  • Creating new ADR: Confirm ADR number (auto-suggest next available)
  • Deleting ADR: Always confirm, suggest "Deprecated" status instead
  • Superseding ADR: Confirm which ADR is being replaced

PROCEED Autonomously When:

  • Updating existing ADR: Add consequences discovered during implementation
  • Linking ADRs: Add related ADR links
  • Fixing typos: Non-destructive corrections
  • Updating status: Proposed → Accepted after team approval

Instructions

When creating an ADR:

  1. Find the next ADR number by checking /docs/architecture/decisions/
  2. Use the MADR template at templates/madr.md
  3. Output to /docs/architecture/decisions/NNNN-[kebab-case-title].md

Template

Use the template at: .claude/skills/create-adr/templates/madr.md

ADR Naming Convention

Format: NNNN-kebab-case-title.md

Examples:

  • 0001-use-supabase-for-database.md
  • 0002-tanstack-query-for-state.md
  • 0003-fumadocs-for-documentation.md

Status Definitions

StatusMeaning
ProposedUnder discussion, not yet decided
AcceptedDecision has been made and applies
DeprecatedNo longer applies, but kept for history
SupersededReplaced by another ADR (link to it)

When to Create an ADR

Create an ADR when:

  • Choosing between technologies/libraries
  • Defining architectural patterns
  • Making decisions that affect multiple parts of the system
  • Making decisions that are hard to reverse
  • Team needs to understand "why" something was done

Output Location

All ADRs go to: /docs/architecture/decisions/NNNN-title.md

Quality Checklist

Before completing:

  • ADR number is sequential (check existing ADRs)
  • Title is clear and descriptive
  • Context explains the problem, not the solution
  • Decision is stated clearly
  • Consequences cover positive, negative, and neutral
  • At least 2 options were considered
  • Related links are included
  • YAML frontmatter has title and description

Examples

Creating New ADRs (Will Ask User)

  • "Create an ADR for choosing Supabase" → Ask: Confirm number 0001?
  • "Record the decision to use TanStack Query" → Suggest next number

Updating Existing ADRs (Autonomous)

  • "Mark ADR-001 as accepted" → Updates status
  • "Add implementation notes to ADR-003" → Adds to Notes section
  • "Link ADR-002 to ADR-005" → Adds to Related section

Status Changes

  • "Deprecate ADR-002" → Updates status, adds deprecation note
  • "ADR-003 supersedes ADR-001" → Updates both ADRs with cross-references

Habilidades Relacionadas

Looking for an alternative to create-adr or another community skill for your workflow? Explore these related open-source skills.

Ver tudo

openclaw-release-maintainer

Logo of openclaw
openclaw

Resumo localizado: 🦞 # OpenClaw Release Maintainer Use this skill for release and publish-time workflow. It covers ai, assistant, crustacean workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 333.8k
⑂ 0
Inteligência Artificial

widget-generator

Logo of f
f

Resumo localizado: Generate customizable widget plugins for the prompts.chat feed system # Widget Generator Skill This skill guides creation of widget plugins for prompts.chat. It covers ai, artificial-intelligence, awesome-list workflows. This AI agent skill supports Claude Code, Cursor, and

★ 149.6k
⑂ 0
Inteligência Artificial

flags

Logo of vercel
vercel

Resumo localizado: The React Framework # Feature Flags Use this skill when adding or changing framework feature flags in Next.js internals. It covers blog, browser, compiler workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 138.4k
⑂ 0
Navegador

pr-review

Logo of pytorch
pytorch

Resumo localizado: Usage Modes No Argument If the user invokes /pr-review with no arguments, do not perform a review. It covers autograd, deep-learning, gpu workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 98.6k
⑂ 0
Desenvolvedor