Yapay zeka destekli geliştirme, yani “vibe coding”, son dönemde birçok geliştiricinin iş akışına girdi. Ancak bu süreçte en sık karşılaşılan sorun şu: Proje büyüdükçe bağlam dağılıyor, aynı şeyleri tekrar tekrar açıklamak zorunda kalıyorsunuz ve her yeni konuşmada token harcaması katlanarak artıyor.

Bunun çözümü, aslında oldukça basit: Skill dosyaları ve proje dosyaları.

Bir projeye başlamadan önce iki temel dosya oluşturmalısınız:

1. Proje dosyası — Ne inşa ettiğinizi, mimariyi, teknoloji yığınını ve kararları belgeler.
2. Skill dosyası — Yapay zekanın o projede nasıl davranması gerektiğini, hangi kalıpları kullanacağını ve neyi yapmaması gerektiğini tanımlar.

Bu dosyalar olmadan, her konuşma sıfırdan başlar. Yapay zeka projenizin bağlamını bilmez; siz de sürekli tekrar edersiniz. Bu hem zaman hem de token israfıdır.

Dosyaları oluşturduktan sonra asıl mesele, onları güncel tutmaktır. Proje geliştikçe mimarî kararlar değişir, yeni bileşenler eklenir, bazı yaklaşımlardan vazgeçilir. Eğer bu değişiklikler skill ve proje dosyalarına yansıtılmazsa, belgeler hızla eskir ve işlevsizleşir.

İşte tam bu noktada sizinle paylaşmak istediğim skill dosyası devreye giriyor. Bu dosya, agent modunda çalışırken yazdıklarınızı otomatik olarak skill dosyalarınıza aktarıp düzenliyor. Yani siz geliştirmeye devam ederken, sistem kendi kendini güncelliyor.

Sonuç: Daha az tekrar, daha az token, daha tutarlı bir proje süreci.

Vibe coding yapıyorsanız ve projenizin kontrolden çıktığını hissediyorsanız, yapmanız gereken ilk şey bu dosyaları oluşturmak. Geri kalanı çok daha kolay hale geliyor.

Kod:

Agent Behavior Skill Update Workflow

This skill is applied when the user requests a change to agent behavior or agent mode settings. The skill is updated first, then the change is applied.

---

Trigger Conditions

Apply this workflow when:

• The user wants to change how the agent operates
• A setting or modification is requested in agent mode
• A persistent behavior rule needs to be added or removed
• Phrases like “change agent behavior,” “add this to the skill,” or “do it this way from now on” are used

---

Workflow Steps

1. Skill Update (First)

Update the relevant skill file to make the change permanent:

Situation	Action
New behavior rule	Add to an existing relevant skill or create a new one
Modification of an existing rule	Update the relevant section in the skill file
Removal of a rule	Remove the relevant item from the skill file

Skill location selection:

• If project-specific: .cursor/skills/<relevant-skill>/SKILL.md
• If general behavior: Add to an existing general skill if one exists; otherwise add to agent-behavior-skill-update or the most appropriate skill

2. Apply the Change (After)

Once the skill update is complete:

• Apply the change in the code, configuration, or relevant location
• Execute the behavior the user requested

---

Example Scenarios

Example 1: “The agent should always run a security check when doing code reviews.”

1. Add a security check item to the code-review skill or relevant skill
2. Apply the security check during the code review process

Example 2: “Don’t apply this rule in this project anymore.”

1. Remove the rule from the relevant skill
2. Remove the rule reference from the current implementation if necessary

Example 3: “Agent mode change: Use English in commit messages.”

1. Add this rule to the commit/versioning skill or project skill
2. Use English when generating commit messages

---

Summary

1. Skill first — Write the change to the skill file (add / modify / remove)
2. Then apply — Implement the requested change in the actual code or config

This order ensures the agent “remembers” the change in future conversations as well.