architecture-decision-records SKILL.md skillA

architecture-decision-records from affaan-m/ecc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add affaan-m/ecc/architecture-decision-records@git:20260517.ec9ace9

Pins git:20260517.ec9ace9 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

affaan-m/ecc

Path

docs/ja-JP/skills/architecture-decision-records/SKILL.md

Versions recorded

1

Latest version

git:20260517.ec9ace9, committed May 17, 2026

Size

8,888 bytes

Repository stars

299,696

License

MIT

コーディングセッション中にアーキテクチャ決定を構造化ADRとして記録し、自動的に決定の瞬間を検出し、コンテキスト、検討された代替案、根拠を記録します。今後の開発者がコードベースの形成理由を理解するためのADRログを維持します。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# アーキテクチャ決定記録

コーディングセッション中にアーキテクチャ決定を構造化ドキュメントとして記録します。決定がSlackスレッド、PRコメント、または誰かの記憶にのみ存在する代わりに、このスキルはコードと並行して存在する構造化ADRドキュメントを生成します。

## アクティベーション時期

- ユーザーが明示的に「この決定を記録しよう」または「このADRを作成しよう」と言う
- 重要な代替案の選択（フレームワーク、ライブラリ、パターン、データベース、API設計）
- ユーザーが「私たちは...を選択した」または「YではなくXをしている理由は...です」と言う
- ユーザーが「なぜXを選んだのか」と尋ねる（既存のADRを読む）
- アーキテクチャ上のトレードオフが検討される計画段階

## ADR形式

Michael Nygardによって提案されたADR形式を、AI支援開発向けに調整したものを使用します：

```markdown
# ADR-NNNN: [決定タイトル]

**Date**: YYYY-MM-DD
**Status**: proposed | accepted | deprecated | superseded by ADR-NNNN
**Deciders**: [関係者]

## Context

この決定または変更を促すどのような問題や状況が見られるのか？

[2～5文で状況、制約条件、作用する力について説明]

## Decision

提案または実施する変更は何か？

[決定を明確に述べる1～3文]

## Alternatives Considered（検討された代替案）

### Alternative 1: [名前]
- **Pros**: [利点]
- **Cons**: [欠点]
- **Why not**: [この選択肢が拒否された特定の理由]

### Alternative 2: [名前]
- **Pros**: [利点]
- **Cons**: [欠点]
- **Why not**: [この選択肢が拒否された特定の理由]

## Consequences（結果）

この変更により、何がより簡単になり、何がより難しくなるか？

### Positive
- [利点1]
- [利点2]

### Negative
- [トレードオフ1]
- [トレードオフ2]

### Risks
- [リスクと軽減策]
```

## ワークフロー

### 新しいADRをキャプチャする

決定の瞬間が検出されたとき：
…

Read the whole file at its exact version.

How to install

mdr add affaan-m/ecc/architecture-decision-records@sha256:c02556b1d916b499

[![mdr](https://markdownregistry.com/badge/art_wr7ejhprmvketeb6.svg)](https://markdownregistry.com/a/art_wr7ejhprmvketeb6)

Versions

The registry has recorded 1 version of this file, committed on May 17, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_wr7ejhprmvketeb6
GET https://markdownregistry.com/api/v1/resolve?ref=affaan-m/ecc/architecture-decision-records
GET https://markdownregistry.com/api/v1/blob/c02556b1d916b499ff45b1e1971da59e894c2268f3a0a7ed051f3391f7536362

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from affaan-m/ecc

Every file in affaan-m/ecc

Other files named architecture-decision-records

Browse by kind, by grade A, or by owner.