decision-log

Create and update ADR/DECISIONS entries from conversation history and code diffs.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/yoshihiko555/dotfiles --skill decision-log-yoshihiko555
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-log
Source: https://github.com/yoshihiko555/dotfiles/tree/main/shared/skills/common/decision-log
Command: npx skills add https://github.com/yoshihiko555/dotfiles --skill decision-log-yoshihiko555

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR/意思決定ログをコミットタイミングで作成・更新するための運用スキル。既存ADR/DECISIONSの形式に合わせ、会話履歴と差分から決定内容を要約して記録する。

Core Features & Use Cases

  • ADR/DECISIONS の最新フォーマットに準拠して決定履歴を整然と残す
  • 会話履歴とコード差分を踏まえ、意思決定の背景と理由を短く要約する
  • コミット直前の変更点と決定を追跡可能にする運用フローの確立

Quick Start

直前の議論と差分を確認し、最新ADRテンプレートに準拠した新規 ADR を作成して DECISIONS.md に追記してください。

Frequently Asked Questions about decision-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically update an ADR decision log at commit time?

To automatically update an ADR decision log at commit time, use a workflow skill that aligns ADR and DECISIONS files with existing project formats. It summarizes rationale from conversation history and code diffs during code reviews and release preparation.

What is the best way to capture architectural decisions from prior conversations?

Capturing architectural decisions from prior conversations involves summarizing discussion history and code diffs into a consistent template. This approach ensures traceable links and careful validation to prevent fabrication when recording decision rationale.

How do I maintain consistent ADR templates across software development projects?

Maintaining consistent ADR templates requires applying a standardized format to new architectural decision records. By aligning new entries with existing DECISIONS.md formats, teams establish an operational flow that keeps decision history traceable and orderly.

Does this decision logging approach work without external dependencies?

Yes, this decision logging approach works without external dependencies. It operates as a standalone workflow skill that uses consistent templates and traceable links to validate and record architectural decisions during the commit process.

What are the limitations of automated decision log generation?

The main limitation of automated decision log generation is the risk of fabrication. It requires careful validation against actual conversation history and code diffs to ensure the summarized rationale accurately reflects true architectural decisions.