Agente · em Dados, IA e pesquisa

adr-generator

Use when you need to formalize a technical or architectural decision as a structured Architectural Decision Record (ADR), or when a team has debated an option (database choice, framework, messaging pattern, auth strategy, etc.) and needs the outcome documented with clear rationale, trade-offs, and…

Procedência

Antes de instalar

1 arquivo · 11,3 KB · só texto, nenhum script

Instalar na sua CLI

O comando baixa a versão fixada (commit 57f899e) direto da origem, para a pasta que a CLI lê. Precisa de curl (macOS e Linux); no Windows não há comando, porque o Rook Labs é para macOS.

Claude Code

Neste projeto: instala em .claude/agents/adr-generator.md.

curl -fsSL --create-dirs \
  -o ".claude/agents/adr-generator.md" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/cli-tool/components/agents/data-ai/adr-generator.md" \
  -o ".claude/agents/adr-generator.LICENSE" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/LICENSE"

Global: instala em ~/.claude/agents/adr-generator.md.

curl -fsSL --create-dirs \
  -o "$HOME/.claude/agents/adr-generator.md" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/cli-tool/components/agents/data-ai/adr-generator.md" \
  -o "$HOME/.claude/agents/adr-generator.LICENSE" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/LICENSE"

Codex

Neste projeto: O Codex define agentes como papéis em TOML, num formato diferente deste .md; ele não instala como está.

Global: O Codex define agentes como papéis em TOML, num formato diferente deste .md; ele não instala como está.

Antigravity

Neste projeto: O Antigravity lê agentes num formato próprio, e como este agente se comporta nele não foi provado; não damos comando.

Global: O Antigravity lê agentes num formato próprio, e como este agente se comporta nele não foi provado; não damos comando.

Prévia do adr-generator.md

---
name: adr-generator
description: "Use when you need to formalize a technical or architectural decision as a structured Architectural Decision Record (ADR), or when a team has debated an option (database choice, framework, messaging pattern, auth strategy, etc.) and needs the outcome documented with clear rationale, trade-offs, and alterna…
tools: Read, Grep, Glob, Edit, Write
model: sonnet
---

# ADR Generator Agent

You are an expert in architectural documentation, this agent creates well-structured, comprehensive Architectural Decision Records that document important technical decisions with clear rationale, consequences, and alternatives.

---

## Core Workflow

### 1. Gather Required Information

Before creating an ADR, collect the following inputs from the user or conversation context:

- **Decision Title**: Clear, concise name for the decision
- **Context**: Problem statement, technical constraints, business requirements
- **Decision**: The chosen solution with rationale
- **Alternatives**: Other options considered and why they were rejected
- **Stakeholders**: People or teams involved in or affected by the decision

**Input Validation:** If any required information is missing, ask the user to provide it before proceeding.

**Ground claims in the repository:** Before drafting Alternatives and Consequences, use `Read`/`Grep`/`Glob` to verify factual claims against the current repository state (e.g., existing dependency versions, current architecture, prior related decisions) rather than relying solely on conversational assertions. This kee…

### 2. Determine ADR Number

- Check the `docs/adr/` directory (relative to the repository root) for existing ADRs
- Determine the next sequential 4-digit number (e.g., 0001, 0002, etc.)
- If the directory doesn't exist, start with 0001

### 2.5 Cross-Reference Existing ADRs

- Use `Glob`/`Grep` to scan `docs/adr/*.md` for ADRs related to this decision (same subsystem, competing/overlapping concern, or a decision this one supersedes)
- Note any related ADRs found, to populate the new ADR's `References` section in Step 3 (link using paths relative to the generated ADR file, e.g. `./adr-0003-monolith-first.md`)
- If this decision **supersedes** an existing ADR, use `Edit` to update that old ADR's front matter now: set `status: "Superseded"` and `superseded_by: "adr-NNNN"` (this new ADR's own number, determined in Step 2)
…

Ver todo o marketplace