{"id":23,"date":"2026-09-23T20:49:18","date_gmt":"2026-09-23T20:49:18","guid":{"rendered":"https:\/\/www.akifsen.com.tr\/blog\/?p=23"},"modified":"2026-09-23T20:49:18","modified_gmt":"2026-09-23T20:49:18","slug":"ai-coding-agents-software-architecture","status":"publish","type":"post","link":"https:\/\/www.akifsen.com.tr\/blog\/2026\/09\/23\/ai-coding-agents-software-architecture\/","title":{"rendered":"AI Kod Yazabiliyor. Peki Mimarinin Da\u011f\u0131lmas\u0131n\u0131 Kim Engelleyecek?"},"content":{"rendered":"\n

AI coding agent’lar\u0131n en etkileyici taraf\u0131 kod yazma h\u0131zlar\u0131.<\/p>\n\n\n\n

Ayn\u0131 zamanda en tehlikeli taraf\u0131 da bu.<\/p>\n\n\n\n

\u00c7\u00fcnk\u00fc yanl\u0131\u015f bir mimari karar art\u0131k yirmi sat\u0131r de\u011fil, birka\u00e7 dakika i\u00e7inde yirmi dosyaya yay\u0131labiliyor.<\/p>\n\n\n\n

Bu nedenle agent tabanl\u0131 geli\u015ftirmede as\u0131l problem prompt engineering de\u011fildir.<\/p>\n\n\n\n

Governance engineering’dir.<\/strong><\/p>\n\n\n\n

\u201cBest practices kullan\u201d bir gereksinim de\u011fildir<\/h2>\n\n\n\n

Bir agente:<\/p>\n\n\n\n

\n

Clean architecture kullan, production ready yap.<\/p>\n<\/blockquote>\n\n\n\n

demek kula\u011fa iyi gelir.<\/p>\n\n\n\n

Ama agent a\u00e7\u0131s\u0131ndan olduk\u00e7a belirsizdir.<\/p>\n\n\n\n

Bunun yerine repository’nin kurallar\u0131 a\u00e7\u0131k bi\u00e7imde tan\u0131mlanmal\u0131d\u0131r.<\/p>\n\n\n\n

\u00d6rne\u011fin:<\/p>\n\n\n\n

Controller may call Application Service only.\nApplication layer owns transaction boundary.\nDomain must not depend on framework classes.\nCross-context writes are forbidden.\nEvery public endpoint requires integration test.<\/code><\/pre>\n\n\n\n
B\u00f6yle bir contract \u00f6l\u00e7\u00fclebilir.<\/p>\n\n\n\n
\u201c\u0130yi kod yaz\u201d de\u011fildir.<\/p>\n\n\n\n
GitHub’\u0131n g\u00fcncel agent\/code-review dok\u00fcmantasyonu da repository-level instructions, AGENTS.md<\/code>, acceptance criteria ve a\u00e7\u0131k task scope’un agent \u00e7\u0131kt\u0131lar\u0131n\u0131n kalitesini art\u0131rd\u0131\u011f\u0131n\u0131 vurguluyor.<\/p>\n\n\n\n
Context’i b\u00fcy\u00fctmek her zaman \u00e7\u00f6z\u00fcm de\u011fildir<\/h2>\n\n\n\n
Bir ba\u015fka refleks agent’a repository’nin tamam\u0131n\u0131 okutmak.<\/p>\n\n\n\n
Daha fazla context her zaman daha iyi sonu\u00e7 \u00fcretmez.<\/p>\n\n\n\n
\u00d6nemli olan do\u011fru context’tir.<\/p>\n\n\n\n
\u00d6rne\u011fin payment feature geli\u015ftirilecekse agent’\u0131n \u00f6ncelikle \u015funlar\u0131 bilmesi gerekir:<\/p>\n\n\n\n
Payment domain contract\nexisting architecture rules\nrelevant ADRs\npayment migrations\nexisting tests\nintegration contracts<\/code><\/pre>\n\n\n\n
\u0130lgisiz 600 dosyay\u0131 okumak karar kalitesini art\u0131rmak yerine g\u00fcr\u00fclt\u00fc olu\u015fturabilir.<\/p>\n\n\n\n
Agent kodu de\u011fil evidence \u00fcretmeli<\/h2>\n\n\n\n
Bir task tamamland\u0131\u011f\u0131nda:<\/p>\n\n\n\n
\n
Done.<\/p>\n<\/blockquote>\n\n\n\n
cevab\u0131 benim i\u00e7in yeterli de\u011fildir.<\/p>\n\n\n\n
Daha iyi completion contract:<\/p>\n\n\n\n
Changed files\nImplemented requirements\nExecuted tests\nTest results\nArchitecture checks\nKnown limitations\nRemaining work<\/code><\/pre>\n\n\n\n
\u015feklindedir.<\/p>\n\n\n\n
B\u00f6ylece agent’\u0131n iddias\u0131 ile repository’nin ger\u00e7ek durumu ayr\u0131labilir.<\/p>\n\n\n\n
Test \u00e7al\u0131\u015ft\u0131rmak review de\u011fildir<\/h2>\n\n\n\n
Agent 148 testin ge\u00e7ti\u011fini s\u00f6yl\u00fcyor.<\/p>\n\n\n\n
G\u00fczel.<\/p>\n\n\n\n
Fakat testler yanl\u0131\u015f davran\u0131\u015f\u0131 do\u011fruluyor olabilir.<\/p>\n\n\n\n
Architecture violation test kapsam\u0131na hi\u00e7 girmemi\u015f olabilir.<\/p>\n\n\n\n
Security problemi test taraf\u0131ndan g\u00f6r\u00fclmeyebilir.<\/p>\n\n\n\n
GitHub da AI-generated kodun requirements, architecture, security ve test a\u00e7\u0131s\u0131ndan insan taraf\u0131ndan do\u011frulanmas\u0131n\u0131 \u00f6neriyor; automated review’\u00fcn insan review’\u00fcn\u00fcn yerine ge\u00e7memesi gerekti\u011fini a\u00e7\u0131k\u00e7a belirtiyor.<\/p>\n\n\n\n
Bu y\u00fczden AI-assisted development’ta insan\u0131n rol\u00fc ortadan kalkm\u0131yor.<\/p>\n\n\n\n
Rol yukar\u0131 ta\u015f\u0131n\u0131yor.<\/p>\n\n\n\n
Daha az boilerplate yaz\u0131yoruz.<\/p>\n\n\n\n
Daha fazla s\u0131n\u0131r, kontrat, acceptance criteria ve do\u011frulama tasarl\u0131yoruz.<\/p>\n\n\n\n
\u00d6n\u00fcm\u00fczdeki d\u00f6nemde senior developer’\u0131 junior’dan ay\u0131ran \u015fey yaln\u0131zca kimin daha h\u0131zl\u0131 kod yazd\u0131\u011f\u0131 olmayacak.<\/p>\n\n\n\n
AI’\u0131n yanl\u0131\u015f kodu \u00e7ok h\u0131zl\u0131 yazmas\u0131n\u0131 kimin engelleyebildi\u011fi olacak.<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"
AI coding agent’lar\u0131n en etkileyici taraf\u0131 kod yazma h\u0131zlar\u0131. Ayn\u0131 zamanda en tehlikeli taraf\u0131 da bu. \u00c7\u00fcnk\u00fc yanl\u0131\u015f bir mimari karar art\u0131k yirmi sat\u0131r de\u011fil, birka\u00e7 dakika i\u00e7inde yirmi dosyaya yay\u0131labiliyor. Bu nedenle agent tabanl\u0131 geli\u015ftirmede as\u0131l problem prompt engineering de\u011fildir. Governance engineering’dir. \u201cBest practices kullan\u201d bir gereksinim de\u011fildir Bir agente: Clean architecture kullan, production […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[],"class_list":["post-23","post","type-post","status-publish","format-standard","hentry","category-mimari"],"_links":{"self":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/23","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/comments?post=23"}],"version-history":[{"count":1,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/23\/revisions"}],"predecessor-version":[{"id":24,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/posts\/23\/revisions\/24"}],"wp:attachment":[{"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/media?parent=23"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/categories?post=23"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.akifsen.com.tr\/blog\/wp-json\/wp\/v2\/tags?post=23"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}