Bagaimana Anda membuat dan mendokumentasikan keputusan teknis yang signifikan?

Question

Accepted Answer

Keputusan teknis yang signifikan harus **deliberat, transparan, dan tercatat**, bukan dibuat di kepala seseorang dan dilupakan. Proses yang baik mengungkap trade-off, membangun konsensus, dan meninggalkan jejak sehingga insinyur di masa depan memahami *mengapa*, bukan hanya *apa*.

## Kerangka kerja untuk pengambilan keputusan

```text
1. FRAME the problem and the constraints (cost, time, team skill, scale)
2. LIST the realistic options — usually 2-4, including "do nothing"
3. EVALUATE each against the constraints and trade-offs
4. DECIDE, and state the reasoning explicitly
5. RECORD it (ADR) and communicate it
6. REVISIT if assumptions change
```

## Catat dengan ADR

**Architecture Decision Record** adalah catatan singkat yang tahan lama:

```markdown
# ADR 014: Use PostgreSQL for the new service

## Status: Accepted

## Context
We need a primary datastore. Team knows SQL; data is relational; scale is moderate.

## Decision
Use PostgreSQL.

## Consequences
+ Strong consistency, team familiarity, rich querying.
- Vertical scaling limits later; revisit if write volume 10x's.

## Alternatives considered
DynamoDB (rejected: relational data, team unfamiliar).
```

## Trade-off yang perlu dikelola

Mendokumentasikan segalanya adalah overhead; tidak mendokumentasikan apa pun kehilangan memori institusional. Cadangkan ADR untuk keputusan yang **mahal untuk dibalik** atau yang akan dipertanyakan oleh insinyur di masa depan.

## Mengapa ini penting

Keputusan yang tidak terdokumentasi akan terus-menerus diperdebatkan ulang, setiap insinyur baru akan bertanya "mengapa kami memilih ini?"

Menulis alasan juga memaksa kejelasan: jika Anda tidak dapat membenarkannya di atas kertas, Anda mungkin belum memikirkannya dengan matang.