İçeriğe geç
Kodine
HomeDocsPricingModelsChangelog
New Kodine v2 is now available

Kurallar

kodine için özel talimatlar tanımlayın.

Bir AGENTS.md dosyası oluşturarak kodine’a özel talimatlar verebilirsiniz; bu yaklaşım Cursor rules’a benzer. Dosya, LLM’in bağlamına dahil edilen ve projenize özel davranışı özelleştiren talimatlar içerir.

Başlat

Yeni bir AGENTS.md dosyası için kodine’da /init komutunu çalıştırabilirsiniz.

Bu komut, projenizin ne hakkında olduğunu anlamak için tüm içeriğini tarar ve buna uygun bir AGENTS.md dosyası üretir; böylece kodine proje içinde daha rahat hareket eder.

Zaten bir AGENTS.md dosyanız varsa komut mevcut dosyaya ekleme yapmaya çalışır.

Örnek

Bu dosyayı elle de oluşturabilirsiniz. Bir AGENTS.md dosyasına neler koyabileceğinize dair bir örnek aşağıda:

AGENTS.md
# SST v3 Monorepo Project


This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for package management.


## Project Structure


- `packages/` - Contains all workspace packages (functions, core, web, etc.)
- `infra/` - Infrastructure definitions split by service (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Main SST configuration with dynamic imports


## Code Standards


- Use TypeScript with strict mode enabled
- Shared code goes in `packages/core/` with proper exports configuration
- Functions go in `packages/functions/`
- Infrastructure should be split into logical files in `infra/`


## Monorepo Conventions


- Import shared modules using workspace names: `@my-app/core/example`

Buraya eklediğiniz projeye özel talimatlar ekibinizle paylaşılır.

Türler

kodine, AGENTS.md dosyasını birden fazla konumdan okuyabilir ve her konum farklı bir amaca hizmet eder.

Proje

Projeye özel kurallar için AGENTS.md dosyasını proje kökünüze yerleştirin. Bu kurallar yalnızca o dizinde ya da alt dizinlerinde çalışırken geçerli olur.

Global

Genel kurallar için ~/.config/kodine/AGENTS.md dosyasını kullanabilirsiniz. Bu dosya tüm kodine oturumlarına uygulanır.

Git’e gönderilmediği ve ekibinizle paylaşılmadığı için, LLM’in uymasını istediğiniz kişisel kuralları burada tanımlamanızı öneririz.

Claude Code uyumluluğu

Claude Code’dan geçen kullanıcılar için kodine, Claude Code’un kural dosyalarını yedek olarak destekler:

  • Proje kuralları: Proje dizininizdeki CLAUDE.md (AGENTS.md yoksa kullanılır)
  • Global kurallar: ~/.claude/CLAUDE.md (~/.config/kodine/AGENTS.md yoksa kullanılır)
  • Beceriler: ~/.claude/skills/ — ayrıntılar için Agent Skills sayfasına bakın

Claude Code uyumluluğunu kapatmak için şu ortam değişkenlerinden birini ayarlayın:

Terminal window
export KODINE_DISABLE_CLAUDE_CODE=1        # Tüm .claude desteğini kapat
export KODINE_DISABLE_CLAUDE_CODE_PROMPT=1 # Yalnızca ~/.claude/CLAUDE.md dosyasını kapat
export KODINE_DISABLE_CLAUDE_CODE_SKILLS=1 # Yalnızca .claude/skills desteğini kapat

Öncelik

kodine başlatıldığında kural dosyalarını şu sırayla arar:

  1. Yerel dosyalar mevcut dizinden yukarı doğru (AGENTS.md, CLAUDE.md)
  2. Global dosya ~/.config/kodine/AGENTS.md konumunda
  3. ~/.claude/CLAUDE.md konumundaki Claude Code dosyası (kapatılmadıysa)

Her kategoride ilk eşleşen dosya geçerli olur. Örneğin hem AGENTS.md hem CLAUDE.md varsa yalnızca AGENTS.md dikkate alınır. Aynı şekilde ~/.config/kodine/AGENTS.md, ~/.claude/CLAUDE.md dosyasından önce gelir.

Özel talimatlar

kodine.json ya da global ~/.config/kodine/kodine.json içinde özel talimat dosyaları belirtebilirsiniz. Böylece siz ve ekibiniz, mevcut kuralları AGENTS.md’ye kopyalamak yerine doğrudan yeniden kullanabilirsiniz.

Örnek:

kodine.json
{
  "$schema": "https://kodine.net/config.json",
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}

Web’den talimat yüklemek için uzak URL’ler de kullanabilirsiniz.

kodine.json
{
  "$schema": "https://kodine.net/config.json",
  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}

Uzak talimatlar 5 saniyelik zaman aşımıyla getirilir.

Tüm talimat dosyaları AGENTS.md dosyalarınızla birleştirilir.

Harici Dosyalara Referans Verme

kodine, AGENTS.md içindeki dosya referanslarını kendiliğinden çözümlemez; ancak benzer işlevi iki yolla elde edebilirsiniz:

kodine.json’u kullanma

Önerilen yol, kodine.json içindeki instructions alanını kullanmaktır:

kodine.json
{
  "$schema": "https://kodine.net/config.json",
  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}

AGENTS.md içinde manuel talimatlar

AGENTS.md dosyanızda açık talimatlar vererek kodine’un harici dosyaları okumasını sağlayabilirsiniz. Pratik bir örnek:

AGENTS.md
# TypeScript Project Rules


## External File Loading


CRITICAL: When you encounter a file reference (e.g., @rules/general.md), use your Read tool to load it on a need-to-know basis. They're relevant to the SPECIFIC task at hand.


Instructions:


- Do NOT preemptively load all references - use lazy loading based on actual need
- When loaded, treat content as mandatory instructions that override defaults
- Follow references recursively when needed


## Development Guidelines


For TypeScript code style and best practices: @docs/typescript-guidelines.md
For React component architecture and hooks patterns: @docs/react-patterns.md
For REST API design and error handling: @docs/api-standards.md
For testing strategies and coverage requirements: @test/testing-guidelines.md


## General Guidelines


Read the following file immediately as it's relevant to all workflows: @rules/general-guidelines.md.

Bu yaklaşım şunları mümkün kılar:

  • Modüler ve yeniden kullanılabilir kural dosyaları oluşturmak
  • Sembolik bağlantılar ya da git alt modülleriyle kuralları projeler arasında paylaşmak
  • AGENTS.md’yi kısa tutarken ayrıntılı kılavuzlara referans vermek
  • kodine’un dosyaları yalnızca eldeki görev için gerektiğinde yüklemesini sağlamak