Install this agent skill to your local

pnpm dlx add-skill https://github.com/vuralserhat86/antigravity-agentic-skills/tree/HEAD/skills/arch_decisions

Skill Files

Browse the full folder contents for arch_decisions.

Download Skill

Loading file tree…

skills/arch_decisions/SKILL.md

Skill Metadata

Name
arch_decisions
Description
ADR template, database selection, capacity planning ve scalability.

📋 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ı? |