- Varsayılan olarak yorum ekleme. Okunabilir kodu, anlamlı isimlendirmeyi ve küçük fonksiyonları tercih et.
- Kodun ne yaptığını yalnızca başka kelimelerle tekrar eden yorumlar yazma.
- Yalnızca koddan anlaşılmayan ve mevcut bağlamdan doğrulanabilen bilgileri yorumla:
- iş kuralları ve bilinçli istisnalar,
- teknik kısıtlamalar ve geçici çözümler,
- güvenlik veya performans tercihleri,
- dış sistemlerin beklenmeyen davranışları,
- ilk bakışta hata gibi görünen bilinçli uygulamalar.
| { | |
| "hooks": { | |
| "Stop": [ | |
| { | |
| "hooks": [ | |
| { | |
| "type": "command", | |
| "command": "osascript -e 'display notification \"Claude işini bitirdi ✅\" with title \"Claude Code\" sound name \"Glass\"'" | |
| } | |
| ] |
Bu repo için AGENTS.md yaz. Amaç kural listesi değil: buraya yeni düşen bir kodlama ajanının (ve yeni ekip üyesinin) hangi hataları yapacağını önceden kesen bir harita.
AŞAMA 1 — Kanıt topla. Önce oku, sonra yaz. Uydurma yok.
- package.json / pyproject / go.mod / Gemfile: script'ler, paket yöneticisi, runtime sürümü pinlenmiş mi (.nvmrc, engines, volta gerçekten var mı?)
- Dizin ağacı (2 seviye). Aynı işi yapan iki klasör var mı? (api/ + apis/, navigations/ + routes/ gibi) — bunlar göç halinde, not al.
- CI dosyaları: gerçekte hangi komutlar çalışıyor, hangileri lokalde gereksiz.
- Kod veya yapılandırma değişikliği yapmadan önce aşağıdaki dosyaları okuyun:
docs/PROJECT_PROFILE.md- Hedef iOS ise
docs/IOS_SHIP_CHECKLIST.md - Hedef Android ise
docs/ANDROID_SHIP_CHECKLIST.md docs/RELEASE_STATUS.md
- Yalnızca
PROJECT_PROFILE.mdiçinde bu proje için etkinleştirilen özellikleri uygulayın.
| # AGENTS.md | |
| - Do not preserve backward compatibility. Remove obsolete paths instead of | |
| adding compatibility layers, fallbacks, or migrations. | |
| - Choose the simplest implementation that fully meets the current | |
| requirements. Avoid speculative abstractions, configuration, and | |
| indirection. | |
| - Grow the system in layers. Start from the smallest version that works end |
Bu repository için “Ne Pişirsem?” adlı Expo React Native mobil uygulamasının MVP planını hazırla.
Henüz uygulama kaynak kodu yazma veya mevcut uygulama dosyalarını değiştirme.
Önce aşağıdaki dosyaları oku:
CLAUDE.md.claude/agents/architect.md.claude/skills/project-conventions/SKILL.mddocs/architecture.md
Bu repository için kontrollü bir multi-agent geliştirme altyapısı oluştur.
Amacımız, güçlü bir planner/architect agent’ın işleri küçük görevlere bölmesi; frontend, backend, test ve review agent’larının ise yalnızca kendi uzmanlık alanlarında çalışmasıdır.
Önce repository’yi analiz et. Kullanılan teknoloji, paket yöneticisi, test sistemi, lint ve typecheck komutlarını mevcut dosyalardan tespit et. Tahmin yürütme. Bulamadığın bilgiler için güvenli ve genel varsayımlar kullan, ancak bunları açıkça belirt.
Aşağıdaki dosya ve klasörleri oluştur:
.claude/
| const { withGradleProperties } = require("expo/config-plugins"); | |
| // This plugin sets the JVM heap size to 4GB | |
| module.exports = (config) => { | |
| config = withGradleProperties(config, (config) => { | |
| const projectGradle = config.modResults; | |
| // Find index of org.gradle.jvmargs | |
| const index = projectGradle.findIndex( | |
| (x) => x.key === "org.gradle.jvmargs", | |
| ); |
| import { useState } from "react"; | |
| const HayaletSevgilim = () => { | |
| const [ceza, setCeza] = useState("Ceza mı bu"); | |
| const [cile, setCile] = useState("Çektiğim çile mi"); | |
| const [nobet, setNobet] = useState("Yıllardır tuttuğum nöbet bitmeyecek mi?"); | |
| const [karTanesi, setKarTanesi] = useState("Bir küçük kar tanesi gibiyim"); | |
| const [don, setDon] = useState("Avucunda eriyen dön bebeğim"); | |
| const [gosyasi, setGozyasi] = useState("Gözyaşlarını görürsem"); | |
| const [kanatlarim, setKanatlarim] = useState("Erir kanatlarım"); |