{"slug": "multi-agent-development-prompt", "title": "Multi-agent development prompt", "summary": "A developer created a multi-agent development infrastructure for a repository, defining a controlled workflow where a planner agent breaks tasks into small assignments for frontend, backend, test, and review agents. The system includes agent configuration files, task schemas, and strict rules to prevent unauthorized code changes and enforce review and integration gates.", "body_md": "Bu repository için kontrollü bir multi-agent geliştirme altyapısı oluştur.\n\nAmacı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.\n\nÖ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.\n\nAşağıdaki dosya ve klasörleri oluştur:\n\n```\n.claude/\n  agents/\n    architect.md\n    frontend-worker.md\n    backend-worker.md\n    test-worker.md\n    reviewer.md\n    integrator.md\n  skills/\n    project-conventions/\n      SKILL.md\n\nCLAUDE.md\n\ndocs/\n  architecture.md\n  decisions.md\n  field-guide.md\n  agent-workflow.md\n\ntasks/\n  task.schema.json\n  example-task.json\n\nscripts/\n  create-agent-worktrees.sh\n  remove-agent-worktrees.sh\n```\n\n- Mevcut uygulama kodunu değiştirme.\n- Dependency ekleme.\n- Package manager değiştirme.\n- Mevcut config dosyalarını değiştirme.\n- Yalnızca yukarıda belirtilen agent altyapısı dosyalarını oluştur.\n- Repository’de var olan komutları ve klasörleri referans al.\n- Yazdığın bütün Markdown dosyaları doğrudan kullanılabilir ve açık olmalı.\n- Agent’ların görev sınırlarını kesin olarak tanımla.\n- Agent’ların gereksiz refactor yapmasını yasakla.\n- Her worker yalnızca kendisine verilen görev ve izin verilen dosyalar üzerinde çalışmalı.\n- Belirsiz durumda agent kod yazmak yerine\n`BLOCKED`\n\nsonucu döndürmeli. - Worker’lar doğrudan ana branch’e merge veya push yapmamalı.\n- Reviewer mümkün olduğunca salt okunur çalışmalı.\n- Integrator yalnızca testleri geçen ve review onayı alan görevleri birleştirmeli.\n\nRepository’nin agent çalışma anayasası olacak şekilde hazırla.\n\nŞunları içersin:\n\n- Projenin tespit edilen teknoloji yığını\n- Paket yöneticisi\n- Geliştirme, lint, test, typecheck ve build komutları\n- Kodlama standartları\n- Dosya ve klasör organizasyonu\n- Yasaklanan davranışlar\n- Agent görev akışı\n`PASS`\n\n,`REQUEST_CHANGES`\n\n,`BLOCKED`\n\nve`FAILED`\n\ndurumlarının anlamları- Her değişiklikten sonra çalıştırılması gereken doğrulamalar\n- Güvenlik ve gizli bilgi kuralları\n- Commit mesajı standardı\n- Agent’ların hangi belgeleri önce okuması gerektiği\n\nRepository’de bulunmayan bir komutu gerçekmiş gibi yazma. Bulunmayan komutların yanına `PROJECT-SPECIFIC COMMAND REQUIRED`\n\nnotu ekle.\n\nHer agent dosyası Claude Code subagent formatında YAML frontmatter içersin.\n\nSorumlulukları:\n\n- Repository ve specification analizi\n- Mimari plan oluşturma\n- İşi küçük ve bağımsız görevlere ayırma\n- Görev bağımlılıklarını belirleme\n- Her görev için izin verilen dosya sınırlarını belirleme\n- Acceptance criteria üretme\n- Riskleri ve belirsizlikleri tespit etme\n\nKurallar:\n\n- Uygulama kodu yazmamalı.\n- Gereksiz mimari değişiklik önermemeli.\n- Her görevi mümkünse 1–5 dosyalık değişiklikle sınırlamalı.\n- Aynı dosyanın birden fazla paralel worker tarafından değiştirilmesini engellemeli.\n- Çıktıyı\n`tasks/task.schema.json`\n\nile uyumlu JSON olarak üretebilmeli.\n\nSorumlulukları:\n\n- UI, component, hook, client state ve frontend entegrasyonları\n- Mevcut tasarım ve mimari kalıplarına uyum\n- İlgili frontend testlerinin çalıştırılması\n\nKurallar:\n\n- Yalnızca görevde izin verilen dosyaları değiştirmeli.\n- Backend, CI veya altyapı değişiklikleri yapmamalı.\n- İstenmeyen refactor yapmamalı.\n- Yeni dependency eklememeli.\n- İş sonunda değişen dosyaları, test sonuçlarını ve riskleri raporlamalı.\n\nSorumlulukları:\n\n- API, server, veri erişimi ve backend iş mantığı\n- Mevcut backend mimarisine uyum\n- İlgili testlerin çalıştırılması\n\nKurallar frontend worker ile aynı katılıkta olmalı.\n\nRepository’de backend bulunmuyorsa bu agent dosyasında açıkça şunu belirt:\n\n`This repository currently appears to have no backend implementation. Use this agent only for backend-related packages or services added outside the current application scope.`\n\nSorumlulukları:\n\n- Unit, integration ve mevcutsa end-to-end testleri\n- Edge case analizi\n- Regression testleri\n- Test fixture ve mock düzenlemeleri\n\nKurallar:\n\n- Production davranışını yalnızca testi kolaylaştırmak için değiştirmemeli.\n- Test geçsin diye assertion zayıflatmamalı.\n- Mevcut test standardını takip etmeli.\n- Flaky testleri gizlememeli.\n- Test kapsamındaki eksikleri raporlamalı.\n\nSorumlulukları:\n\n- Specification uyumu\n- Kod doğruluğu\n- Type safety\n- Test yeterliliği\n- Güvenlik\n- Performans\n- Gereksiz değişiklik\n- Dosya sınırı ihlali\n- Mimari uyum\n\nMümkünse yalnızca read, grep, glob ve test komutlarına erişsin.\n\nKod yazmamalı.\n\nÇıktısı kesin olarak şu formatta olmalı:\n\n```\nRESULT: PASS | REQUEST_CHANGES | BLOCKED\n\nSUMMARY:\n...\n\nFINDINGS:\n- severity: critical | high | medium | low\n  file:\n  line:\n  issue:\n  recommendation:\n\nVERIFICATION:\n- command:\n  result:\n\nRISKS:\n...\n```\n\nSorumlulukları:\n\n- Worker commit’lerini değerlendirmek\n- Bağımlılık sırasına göre birleştirmek\n- Merge conflict’lerini semantik olarak çözmek\n- Birleşmiş branch üzerinde lint, test, typecheck ve build çalıştırmak\n- Başarısız entegrasyonda değişikliği geri almak veya\n`BLOCKED`\n\ndöndürmek\n\nKurallar:\n\n- Review onayı olmayan değişikliği birleştirmemeli.\n- Testleri atlamamalı.\n- Conflict çözerken özellik kaybına neden olmamalı.\n- Ana branch’e otomatik push yapmamalı.\n- Force push yapmamalı.\n\n`.claude/skills/project-conventions/SKILL.md`\n\ndosyasında repository’ye özel ortak kuralları tanımla.\n\nŞunları kapsasın:\n\n- İsimlendirme\n- Import düzeni\n- TypeScript kuralları\n- Component ve hook kuralları\n- State management yaklaşımı\n- API çağrı yaklaşımı\n- Error ve loading state yaklaşımı\n- Test yaklaşımı\n- Accessibility\n- Logging\n- Environment variable kullanımı\n- Gizli bilgi yönetimi\n- Agent raporlama formatı\n\nRepository’de gördüğün gerçek kod örüntülerine dayan. Emin olmadığın konulara `Needs project confirmation`\n\netiketi koy.\n\nMevcut repository’nin kısa ve gerçekçi mimari özetini oluştur.\n\nŞunları kapsasın:\n\n- Uygulama türü\n- Ana klasörler\n- Veri akışı\n- State yönetimi\n- API katmanı\n- Navigation veya routing\n- Test yapısı\n- Build ve deployment hakkında tespit edilebilen bilgiler\n- Bilinen mimari sınırlar\n\nBilgi uydurma. Tespit edilemeyen alanları açıkça belirt.\n\nArchitecture Decision Record benzeri basit bir format oluştur.\n\nÖrnek şablon:\n\n```\n## ADR-001: Karar başlığı\n\n- Status:\n- Date:\n- Context:\n- Decision:\n- Consequences:\n- Alternatives considered:\n```\n\nİlk karar olarak multi-agent çalışma modelinin neden worktree, dar görev sınırı ve bağımsız review kullandığını açıkla.\n\nAgent’ların proje içinde keşfettiği tekrar kullanılabilir bilgileri yazacağı bir yapı oluştur.\n\nBölümler:\n\n- Architecture notes\n- Development commands\n- Testing notes\n- Known pitfalls\n- Security notes\n- Performance notes\n- Integration notes\n\nDosyada agent’ların geçici görev bilgisi veya konuşma özeti saklamaması gerektiğini belirt.\n\nBaşından sonuna çalışma akışını yaz:\n\n- Specification alınması\n- Architect analizi\n- Görev JSON’larının üretilmesi\n- Worktree oluşturulması\n- Worker’ın görevi uygulaması\n- Testlerin çalıştırılması\n- Reviewer kontrolü\n- Değişiklik talebi veya onay\n- Integrator merge işlemi\n- Birleşmiş kodun doğrulanması\n- Field guide ve decisions güncellemesi\n- Final rapor\n\nAyrıca paralel çalıştırma kurallarını belirt:\n\n- Aynı dosyayı değiştiren görevler paralel çalışamaz.\n- Bağımlılığı tamamlanmamış görev başlatılamaz.\n- Varsayılan concurrency en fazla 3 worker olmalı.\n- Her görev en fazla 2 otomatik retry almalı.\n- İkinci başarısızlıktan sonra\n`BLOCKED`\n\nolmalı.\n\n`tasks/task.schema.json`\n\ngeçerli JSON Schema olsun.\n\nŞu alanları içersin:\n\n```\nid\ntitle\nobjective\ndescription\nassignedAgent\npriority\nstatus\ndependencies\nacceptanceCriteria\nfilesAllowed\nfilesForbidden\ncommands\nrisks\nassumptions\nworktree\nbranch\nattempts\nmaxAttempts\nresult\ncommit\nreviewResult\ncreatedAt\nupdatedAt\n```\n\nStatus enum:\n\n```\npending\nready\nrunning\nreview\nchanges_requested\napproved\nintegrating\ncompleted\nblocked\nfailed\n```\n\nAssigned agent enum:\n\n```\narchitect\nfrontend-worker\nbackend-worker\ntest-worker\nreviewer\nintegrator\n```\n\n`filesAllowed`\n\n, `acceptanceCriteria`\n\nve `commands`\n\nboş bırakılamasın.\n\n`maxAttempts`\n\nvarsayılan olarak 2 olsun.\n\nRepository’ye uygun, küçük ve risksiz bir örnek görev oluştur.\n\nÖrnek görev gerçek uygulama kodunu değiştirmeyi gerektirmesin. Dokümantasyon veya basit bir test altyapısı incelemesi olabilir.\n\n`scripts/create-agent-worktrees.sh`\n\n:\n\n- Bash strict mode kullansın.\n- Repository root’unu otomatik tespit etsin.\n- Varsayılan olarak şu worktree’leri hazırlasın:\n\n```\n../<project-name>-frontend\n../<project-name>-backend\n../<project-name>-tests\n../<project-name>-review\n../<project-name>-integration\n```\n\n- Branch isimleri şu formatta olsun:\n\n```\nswarm/frontend\nswarm/backend\nswarm/tests\nswarm/review\nswarm/integration\n```\n\n- Branch veya worktree zaten varsa güvenli şekilde uyarı versin.\n- Mevcut veriyi silmesin.\n- Force kullanmasın.\n- Çalıştırma sonunda oluşturulan worktree’leri listeylesin.\n\n`scripts/remove-agent-worktrees.sh`\n\n:\n\n- Yalnızca bu altyapının oluşturduğu worktree’leri hedeflesin.\n- Kirli worktree varsa silmesin.\n- Force kullanmasın.\n- Branch’leri varsayılan olarak silmesin.\n- Kullanıcıya yapılan ve atlanan işlemleri raporlasın.\n\nHer iki script için de çalıştırılabilir izin gerektiğini final raporunda belirt. İzin değişikliğini uygulayabiliyorsan uygula.\n\nDosyaları oluşturduktan sonra şu sırayla rapor ver:\n\n- Tespit edilen proje yapısı\n- Oluşturulan dosyalar\n- Her agent’ın kısa görevi\n- Tespit edilemeyen veya doğrulanması gereken bilgiler\n- Kullanım komutları\n- Önerilen ilk deneme görevi\n- Oluşturulan altyapının sınırlamaları\n\nSon olarak aşağıdaki doğrulamaları yap:\n\n- JSON dosyalarının parse edilebildiğini kontrol et.\n- Shell scriptlerine\n`bash -n`\n\nuygula. - Markdown frontmatter alanlarını gözden geçir.\n- Oluşturulan dosyalar dışında değişiklik yapılmadığını\n`git diff --stat`\n\nile doğrula.\n\nDoğrulama başarısız olursa problemi düzelt ve tekrar çalıştır.\n\nŞimdi repository’yi incele, dosyaları oluştur ve doğrulamaları tamamla.", "url": "https://wpnews.pro/news/multi-agent-development-prompt", "canonical_source": "https://gist.github.com/zaferayan/3d88a28dd856881c031d1fcdb28d2063", "published_at": "2026-07-21 14:07:54+00:00", "updated_at": "2026-07-21 14:48:01.054162+00:00", "lang": "en", "topics": ["developer-tools", "artificial-intelligence", "ai-agents"], "entities": ["Claude Code"], "alternates": {"html": "https://wpnews.pro/news/multi-agent-development-prompt", "markdown": "https://wpnews.pro/news/multi-agent-development-prompt.md", "text": "https://wpnews.pro/news/multi-agent-development-prompt.txt", "jsonld": "https://wpnews.pro/news/multi-agent-development-prompt.jsonld"}}