LucasBiason/adr-writer
.claude/skills/workflow/adr-writer/SKILL.md
Cria Architecture Decision Records (ADRs) para decisões técnicas. Inclui alternativas, justificativa e consequências.
$ install --global
skillsauthnpx skillsauth add LucasBiason/engineering-knowledge-base adr-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:59 PM2.0s1 file scanned
SKILL.md
- name:
- adr-writer
- description:
- Cria Architecture Decision Records (ADRs) para decisões técnicas. Inclui alternativas, justificativa e consequências.
- triggers:
- [adr, decision, architecture decision, trade-off]
ADR Writer
Purpose
Create Architecture Decision Records (ADRs) whenever:
- A trade-off exists
- Multiple viable options exist
- A choice impacts future development
This skill makes decisions explicit, documented, and reviewable.
When to Use
- Plan Lead or user identifies a design trade-off
- Deciding: architecture patterns, storage, auth, inter-service communication, CI/CD, observability, data consistency
Do NOT use ADRs for trivial choices.
Output Files
- spec/90-decisions/ADR-XXXX-<slug>.md
Rules
- Every ADR must include at least 2 alternatives.
- Must explicitly state why alternatives were rejected.
- Must list consequences (positive + negative).
- If decision depends on unknowns → mark ADR as
PROPOSEDnotACCEPTED. - Keep ADRs short and actionable.
ADR Statuses
PROPOSED | ACCEPTED | SUPERSEDED | REJECTED
Process
Step 0 — Identify the Decision
Write a 1–2 sentence "decision statement".
Step 1 — Gather Options
List 2–4 realistic alternatives.
Step 2 — Evaluation Criteria
Define what matters: Cost, Complexity, Team familiarity, Performance, Security, Vendor lock-in, Operational burden.
Step 3 — Choose + Justify
Pick one, explain why.
Step 4 — Consequences
List: Immediate consequences, Long-term consequences, Migration impact (if any).
Template
ADR-XXXX — <Title>. Status: PROPOSED. Date, Decision owners. Context. Decision. Options Considered (Option A/B with Pros/Cons). Decision Rationale. Consequences (Positive, Negative, Operational, Security/Compliance, Migration). Open Questions (if any).
Related Skills
LucasBiason/test-runner
testing
VerifiedTrustedCommunity
Execução e análise de testes automatizados
1SKILL.mdUpdated Apr 17, 2026
LucasBiason/study-summary-rich
development
VerifiedTrustedCommunity
Gera resumos didáticos extensos e estruturados de aulas/cursos para cards do Notion. Use ao resumir aulas, apostilas, transcrições ou materiais de estudo para incluir no corpo do card (não apenas no campo Descrição), com flashcards, exemplos de código, diagramas Mermaid, mapa conceitual e perguntas de reforço.
1SKILL.mdUpdated Apr 17, 2026
LucasBiason/spec-normalizer
development
VerifiedTrustedCommunity
Padroniza documentação existente no formato canônico Spec-Driven. Remove duplicação e melhora rastreabilidade.
1SKILL.mdUpdated Apr 17, 2026
LucasBiason/spec-driven-core
development
VerifiedTrustedCommunity
Processo universal e repetível para criar especificações a partir de qualquer input (texto, docs, código). Usado em Plan mode.
1SKILL.mdUpdated Apr 17, 2026