Claude-skill-registry arch_decisions

ADR template, database selection, capacity planning ve scalability.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/arch-decisions" ~/.claude/skills/majiayu000-claude-skill-registry-arch-decisions && rm -rf "$T"

manifest: skills/data/arch-decisions/SKILL.md

📋 Architecture Decisions

ADR, database selection ve capacity planning.

📝 ADR Template

# ADR-001: Database Selection

## Status: Accepted

## Context
[Problem açıklaması]

## Decision
PostgreSQL kullanacağız.

## Consequences
### Positive
- ACID compliance
### Negative
- Horizontal scaling zor

## Alternatives
- MongoDB: Rejected - JOINs için uygun değil

🗄️ Database Selection

SQL	NoSQL
Complex JOINs	Flexible schema
ACID	High throughput
Transactions	Horizontal scale

📊 Capacity Planning

DAU: 1M users
Requests: 20/user/day = 20M/day
RPS: 20M / 86400 = ~230 RPS
Peak: 230 × 3 = ~700 RPS

Architecture Decisions v1.0

🔄 Workflow

Kaynak: AWS Architecture Blog

Aşama 1: Problem Identification

Context: Problemi ve etkilerini net tanımla.
Constraints: Kısıtlamaları (Bütçe, Zaman, Teknoloji) belirle.
Options: En az 2 alternatif çözüm yolu belirle.

Aşama 2: Proposal (Status: Proposed)

Draft: ADR şablonunu doldur.
RFC: Takımdan yorum iste (Pull Request veya Toplantı).
Evaluation: Alternatifleri kriterlere göre puanla (Pros/Cons).

Aşama 3: Decision (Status: Accepted/Rejected)

Consensus: Kararı netleştir ve statüyü güncelle.
Implications: Kararın uzun vadeli etkilerini (Consequences) yaz.
Commit: ADR dosyasını repoya ekle.

Kontrol Noktaları

Aşama	Doğrulama
1	Problem ve alternatifler net mi?
2	Takım görüşü alındı mı?
3	Kararın "Consequences" bölümü dürüstçe yazıldı mı?