documentation-and-adrs SKILL.md skillA

documentation-and-adrs from dannykkh/skill-olympus is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add dannykkh/skill-olympus/documentation-and-adrs@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

dannykkh/skill-olympus

Path

skills/documentation-and-adrs/SKILL.md

Versions recorded

2

Latest version

v1.0.0, committed Sep 1, 2026

First version recorded

Apr 20, 2026

Size

6,924 bytes

Repository stars

7

License

MIT

Architecture Decision Records(ADR) 작성 + 기술 문서화 자동화. 아키텍처 결정을 구조화된 ADR로 기록하고, API 문서·README·기술 가이드를 생성. "ADR 작성", "아키텍처 결정 기록", "기술 문서화", "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

# Documentation & ADRs — 아키텍처 결정 기록 + 기술 문서화

> 아키텍처 결정을 **왜** 했는지 기록하고, 나중에 돌아볼 수 있게 만든다.
> 코드는 "무엇"을 말하고, 커밋은 "언제"를 말하지만, ADR만이 **"왜"**를 말한다.

## Quick Start

```
/adr                          # 대화형 ADR 작성
/adr "Redis를 캐시로 선택"      # 제목 지정하여 ADR 작성
/adr list                     # 기존 ADR 목록 조회
/adr status                   # ADR 현황 (accepted/superseded/deprecated)
```

**공식 호출명:** `/adr` (별칭: `아키텍처 결정`, `decision record`, `기술 문서화`)

## 적용 시점

| 상황 | 적용 |
|------|------|
| 기술 스택 선택 (DB, 프레임워크, 라이브러리) | O |
| 아키텍처 패턴 결정 (모놀리스 vs 마이크로서비스) | O |
| 기존 결정 변경/폐기 | O |
| 팀 간 API 계약 변경 | O |
| 단순 버그 수정, UI 미세 조정 | X |
| 이미 ADR이 존재하는 결정 | X (업데이트만) |

---

## CRITICAL: First Actions

### 1. Print Intro

```
Documentation & ADRs — 아키텍처 결정 기록
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
순서: Detect → Interview → Write → Link → Verify
```

### 2. ADR 디렉토리 감지

```bash
# ADR 디렉토리 찾기
_ADR_DIR=""
for dir in docs/adr docs/decisions adr decisions doc/adr; do
  [ -d "$dir" ] && _ADR_DIR="$dir" && break
done

# 없으면 생성 제안
if [ -z "$_ADR_DIR" ]; then
  echo "ADR 디렉토리 없음 — docs/adr/ 생성 권장"
  _ADR_DIR="docs/adr"
fi

# 기존 ADR 번호 확인
…

Read the whole file at its exact version.

How to install

mdr add dannykkh/skill-olympus/documentation-and-adrs@sha256:0af51cf774f5a8f9

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

Versions

The registry has recorded 2 versions of this file, between Apr 20, 2026 and Sep 1, 2026, about one every 134 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_scwxd27oxq6mhdzc
GET https://markdownregistry.com/api/v1/resolve?ref=dannykkh/skill-olympus/documentation-and-adrs
GET https://markdownregistry.com/api/v1/blob/0af51cf774f5a8f9a203830164ed0eba05310a7be96878e5b6bebf5947f26db9

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 dannykkh/skill-olympus

Every file in dannykkh/skill-olympus

Other files named documentation-and-adrs

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