---
name: agents_md
router_kit: AIKit
description: AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.
metadata:
  skillport:
    category: development
    tags: [agents, agents md, algorithms, artificial intelligence, automation, chatbots, cognitive services, deep learning, embeddings, frameworks, generative ai, inference, large language models, llm, machine learning, model fine-tuning, natural language processing, neural networks, nlp, openai, prompt engineering, rag, retrieval augmented generation, tools, vector databases, workflow automation]      - conventions
---

# 🤖 AGENTS.md

> Agent instruction ve conventions dosyaları oluşturma rehberi.

---

## 📋 AGENTS.md Nedir?

AGENTS.md, AI coding assistant'ların proje özelinde kurallara uymasını sağlayan convention dosyasıdır.

### Kullanım Alanları
- Proje spesifik kurallar
- Kod stili conventions
- Dizin yapısı açıklamaları
- Yasaklı pattern'ler
- Önerilen yaklaşımlar

---

## 📁 Root AGENTS.md Template

```markdown
# AGENTS.md

Bu proje için AI assistant kuralları.

## Proje Genel Bakış
[Projenin kısa açıklaması]

## Tech Stack
- Framework: Next.js 15
- Language: TypeScript
- Styling: Tailwind CSS
- Database: PostgreSQL

## Dizin Yapısı
\`\`\`
src/
├── app/           # Next.js App Router pages
├── components/    # React components
├── lib/           # Utility functions
├── hooks/         # Custom React hooks
└── types/         # TypeScript types
\`\`\`

## Kod Conventions

### Naming
- Components: PascalCase (`UserProfile.tsx`)
- Hooks: camelCase with `use` prefix (`useAuth.ts`)
- Utils: camelCase (`formatDate.ts`)

### Imports
- Absolute imports: `@/components/...`
- Group order: React > External > Internal > Types

## Yasaklar
- ❌ `any` type kullanma
- ❌ `console.log` production'da
- ❌ Inline styles

## Tercih Edilenler
- ✅ Server Components (default)
- ✅ Zod validation
- ✅ Error boundaries
```

---

## 📂 Nested AGENTS.md (Modül Bazlı)

### src/components/AGENTS.md
```markdown
# Components Conventions

## Component Yapısı
\`\`\`tsx
// 1. Imports
// 2. Types
// 3. Component
// 4. Export
\`\`\`

## Props
- Interface ile tanımla
- `Props` suffix kullan

## Styling
- Tailwind class'ları kullan
- `cn()` utility ile merge
```

### src/api/AGENTS.md
```markdown
# API Conventions

## Endpoint Yapısı
- RESTful naming
- Versioning: `/api/v1/`

## Error Handling
- Consistent error response format
- HTTP status codes doğru kullan
```

---

## 🗺️ Feature Map

```markdown
## Feature: User Authentication

### Paths
- Entry: `src/app/(auth)/login/page.tsx`
- API: `src/app/api/auth/[...nextauth]/route.ts`
- Components: `src/components/auth/`
- Hooks: `src/hooks/useAuth.ts`

### Tests
- Unit: `__tests__/auth/`
- E2E: `e2e/auth.spec.ts`

### Docs
- `docs/auth.md`
```

---

## 🔄 Monorepo Yapısı

```markdown
# Monorepo AGENTS.md

## Packages
| Package | Path | Purpose |
|---------|------|---------|
| @acme/web | apps/web | Next.js frontend |
| @acme/api | apps/api | Express backend |
| @acme/ui | packages/ui | Shared components |
| @acme/utils | packages/utils | Shared utilities |

## Cross-Package Rules
- UI components: `@acme/ui` kullan
- Utils: `@acme/utils` kullan
- Duplicate code yasak
```

---

*AGENTS.md v1.0 - Convention Over Configuration*

## 🔄 Workflow

> **Kaynak:** [AGENTS.md Best Practices](https://agents.md)

### Aşama 1: Context Extraction
- [ ] **Read Project Config**: `package.json`, `tsconfig.json`, `.eslintrc`.
- [ ] **Map Directory Structure**: Identify key folders (`src`, `app`, `lib`).
- [ ] **Identify Unwritten Rules**: Look at existing code for naming patterns (PascalCase vs camelCase).

### Aşama 2: Root Creation (`/AGENTS.md`)
- [ ] **Project Overview**: One sentence goal description.
- [ ] **Tech Stack**: List core frameworks and libraries.
- [ ] **Architecture**: High-level map of the system.
- [ ] **Conventions**: Explicit naming and coding rules.

### Aşama 3: Rule Definitions
- [ ] **Must Haves**: "Always use TypeScript strict mode", "Always use Zod".
- [ ] **Must Nots**: "No `any`", "No `console.log` in prod", "No class components".
- [ ] **Preferred**: "Prefer functional components", "Prefer arrow functions".

### Aşama 4: Nested & Maintenance
- [ ] **Sub-modules**: Create specific `AGENTS.md` for `src/components`, `src/api` if complex.
- [ ] **Sync**: Update `AGENTS.md` when adding new tech or changing patterns.

### Kontrol Noktaları
| Aşama | Doğrulama |
|-------|-----------|
| 1 | Proje yapısı doğru anlaşılmış |
| 2 | Root dosya mevcut ve okunabilir |
| 3 | AI kuralları ihlal etmiyor (test et) |