Unajua vipi na kurekodi maamuzi makubwa ya kiufundi?

Question

Accepted Answer

Maamuzi makubwa ya kiufundi yanapaswa kuwa **yenye nia, ya uwazi, na kwa mafanikio**, si yenye kufanywa katika kichwa cha mtu na kusahauliwa. Mchakato mzuri unafungua uzani, kujenga makubaliano, na kuacha njia ili wahandisi wa baadaye waelewe *kwa nini*, si tu *nini*.

## Sura ya uamuzi

```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
```

## Irekodihaini na ADR

Ni **Architecture Decision Record** ni rekodi fupi, imara:

```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).
```

## Uzani wa kusimamia

Kudokumenti kila kitu ni dharura; kutodokumenti kitu chochote kupoteza kumbukumbu ya taasisi. Ahirisha ADRs kwa maamuzi ambayo ni **ghali kugeuzwa** au ambayo wahandisi wa baadaye watauliza.

## Kwa nini ni muhimu

Maamuzi yasiyotaka kurekodwa hurekodwa kwa muda mrefu, kila wahandisi mpya huuliza "kwa nini tulipili hii?"

Kuandika sababu pia hutumia uwazi: ikiwa huwezi kulizwa juu ya karatasi, pengine hutajifikiria vizuri.