Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install seb155-atlas-plugin-dist-atlas-dev-addon-skills-workflow-adr-loggit clone https://github.com/seb155/atlas-plugin.gitcp atlas-plugin/SKILL.MD ~/.claude/skills/seb155-atlas-plugin-dist-atlas-dev-addon-skills-workflow-adr-log/SKILL.md---
name: workflow-adr-log
description: "Decision-log → ADR template → index update. Formal architectural decision record with context + decision + consequences."
mode: [engineering]
effort: low
superpowers_pattern: [iron_law, red_flags, hard_gate]
see_also: [decision-log, workflow-architecture, workflow-facilitate-decision]
thinking_mode: adaptive
version: 6.1.0
tier: [core, dev, admin]
category: documentation
emoji: "📜"
triggers: ["ADR", "decision record", "architectural decision", "document decision"]
schema_version: 1
output_schema_ref: ".blueprint/schemas/workflow-step-result-v1.json"
resumable: true
parallelizable_groups: []
estimated_duration_min: 30
persona_tags: [engineer, architect]
requires_hitl: false
workflow_steps:
- step: 1
name: "Context gather"
skill: context-discovery
gate: MANDATORY
purpose: "Load related decisions from .claude/decisions.jsonl + prior ADRs"
parallelizable: false
depends_on: []
model_preference: sonnet
effort: low
- step: 2
name: "ADR draft"
skill: document-generator
gate: MANDATORY
purpose: "Template: Status, Context, Decision, Consequences, Alternatives considered"
parallelizable: false
depends_on: [1]
model_preference: opus
effort: medium
- step: 3
name: "Append decision log"
skill: decision-log
gate: HARD_GATE
purpose: ".claude/decisions.jsonl + .blueprint/adrs/00NN-slug.md + index update"
parallelizable: false
depends_on: [2]
model_preference: haiku
effort: low
---
<HARD-GATE>
EVERY NON-OBVIOUS DECISION GETS AN ADR.
'Non-obvious' = would surprise a new teammate reading code. Document the WHY.
</HARD-GATE>
<red-flags>
| Thought | Reality |
|---|---|
| "This decision is obvious" | Obvious to you. 6 months / teammate / future-you needs the rationale. |
| "We'll remember why" | No you won't. Write it down. |
| "ADR is overhead" | 10 min ADR = hours saved later when someone asks 'why did we pick X?'. |
</red-flags>
# Workflow: ADR Log
## ADR template structure
```markdown
# ADR-00NN: <Decision title>
**Status**: proposed | accepted | superseded | deprecated
**Date**: YYYY-MM-DD
**Deciders**: <names>
## Context
<The situation that led to this decision>
## Decision
<What we decided>
## Consequences
**Positive**:
- <benefit>
**Negative**:
- <tradeoff>
## Alternatives considered
- **Option A**: <description> — <why rejected>
- **Option B**: <description> — <why rejected>
```
## Success output
```json
{
"workflow": "adr-log",
"status": "completed",
"adr_path": ".blueprint/adrs/00NN-slug.md",
"decisions_jsonl_entry_added": true,
"index_updated": true,
"adr_number": N
}
```